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PREFACE 



The KRONOS Time-Sharing System was developed by Control Data Corporation to provide 
remote interactive job processing for CONTROL DATA® CYBER 70 Series Model 72, 73, 
and 74 Computer Systems and for CONTROL DATA® 6000 Series Computer Systems. 
This interactive job processing capability is provided in addition to the local and remote 
batch processing capabilities available under KRONOS. 

This manual describes communication between a remote time-sharing terminal user and 
the KRONOS Time-Sharing System. It contains a description of the subsystems available 
to the user and the procedures necessary to use the capabilities of these subsystems. 
However, this manual does not contain programming information for these subsystems. 
Sections 4 and 5 of this manual may be particularly useful to the inexperienced user as 
well as the more experienced user. These sections describe the command set available 
to all time-sharing users. Included are terminal control, subsystem selection, file 
creation, and file maintenance commands. The more experienced user may be interested 
in the ability to enter control card images, either one at a time, or as a batch job image, 
from the terminal. These features are described in sections 8 and 9. 



The reader should note that this product is intended for use only as described in this 
document. Control Data cannot be responsible for the proper functioning of undescribed 
features or undefined parameters. 

The following manuals contain additional information of interest to the user of the KRONOS 
Time-Sharing System. 
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The following manuals describe the products common to KRONOS and the CONTROL DATA® 
SCOPE operating system. 
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INTRODUCTION 



The KRONOS Time-Sharing System provides a user with general purpose or specialized 
time-sharing capabilities. It can be used from any location simply by dialing the com- 
puter's telephone number. 

Since KRONOS is capable of serving a large number of users simultaneously, the cost 
of using the system is only a fraction of that of conventional data processing systems. 
This is combined with the speed and convenience of a conversational system. 

Although a large number of users may be accessing KRONOS at the same time, the 
sophisticated software that controls the system assures the complete separation of each 
activity. Thus, each user may conceptually imagine that he is the only user of the 
system. 

To further enhance the convenience of programming, the KRONOS system maintains 
control of all information (files) created by its users. Prior to creating a file, it is 
named and may subsequently be requested by that name at any time. 

The KRONOS system is inherently secure. It assumes that any file created belongs 
exclusively to the person creating it and will deny any other user's request to access 
it. However, a user can also specify that a file be made available to other users. 

In order to use the system, it is necessary to know its telephone number and be able 
to supply identification consisting of a user number and optionally, a password, charge 
number, and project number. After dialing the appropriate telephone number and making 
connection with the computer, the system requests the user indentification. In some 
cases, the terminal being used may also require identification. If the identification is 
legitimate, access to the KRONOS system occurs immediately. 

In summary, the KRONOS system is a powerful, sophisticated time-sharing system 
which can satisfy a wide spectrum of computational needs of its users. Its conversa- 
tional capabilities permit its users to debug their programs much faster than with other 
data processing systems. Its peripheral mass storage and advanced file maintenance 
techniques permit vast amounts of information to be stored at high speeds. The fact 
that the system can be used from terminals in remote locations creates an environment 
in which many users can be performing work in the privacy of their own offices, with- 
out the inconvenience of traveling to the computer site. 

TERMINALS 

All communication with the computer can take place via a remote terminal. Programs 
or data are sent to the computer according to specific rules or commands. The com- 
puter responds by sending its answers on the terminal. If the user attempts to process I 
an incorrect command, the computer rejects the command and prints the reason for 
its rejection. 
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Two types of terminals may be used to communicate with KRONOS. 

• ASCII code compatible terminals (such as Teletype® models 33, 35, 37, 
and 38, Memorex 1240, CDC 713, etc.) 

• Correspondence code terminals (such as Novar 5-41, Datel 30, IBM 2741, 
etc. ) 

If a correspondence code terminal is to be used, KRONOS requires that the communi- 
cations system equipment be modified to accommodate this type of terminal. In 
addition, modification is also required if transmission speeds greater than ten characters 
per second are required. 

Most time-sharing operations can be performed using either type of terminal. Differ- 
ences in operation are described, when applicable, throughout this manual. A summary 
of these differences is described in Table B-1 of appendix B. 

SUBSYSTEMS 

After identifying himself to the system, the user can specify a subsystem to be used. 
The available subsystems are: 

« BASIC An elementary programming language used for scientific applica- 

tions. This easily learned language is quickly adaptable to the 
needs of engineers, businessmen, educators, and other fields. 
It requires neither computer background nor training in higher 
mathematics. 

• BATCH Provides the user with a batch control card capability from the 

terminal. It enables a user to type control card images at his 
terminal that would normally have to be entered from a card 
reader at the central site nr from a remote batch environment. 

« EXECUTE Allows a user to execute a previously compiled program. Since 

a majority of the time spent on a job is for compilation, this 
subsystem provides an efficient means to run a frequently used 
program without having to recompile it each time. 

« FORTRAN Translates mathematical language into machine language to solve 

mathematical and engineering problems. The time-sharing 
FORTRAN subsystem provides a convenient language for expressing 
mathematical and scientific problems and a convenient method for 
data input and output. 

, NULL Allows the user to perform file manipulations and other time-sharing 

operations without subsystem association. 

CONVENTIONS 

Throughout this manual, the following conventions are used. . 

, (cr) denotes the RETURN key on the terminal keybp^d. Each line of 
time-sharing terminal input must be followed by a (CK . The system 
responds by performing a carriage return and line fe^ operation (positions 
carriage to first character position on the next line). 

, The word system refers to the KRONOS Operating System which provides 
the interface between KRONOS and the user's program. 

, The vertical spacing in examples does not necessarily coincide with the 
spacing that will appear on the user's terminal. 
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It is recommended that a new user refer to the glossary to become familiar with 
terms used in this manual and other KRONOS manuals. 
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INTRODUCTION TO KRONOS PROCESSING 



This section is intended primarily for users unfamiliar with the KRONOS Time-Sharing 
System. It is designed as a guide to be used for the first session at a time-sharing 
terminal. Included are instructions necessary to gain access to the system (log-in), 
enter and run a simple program in the BASIC language, and finally, leave the system 
(log-off). Don't be nervous. You cannot harm the system by making incorrect entries 
or other mistakes at your terminal. The error will merely be detected by the system 
which in turn issues a routine error message (probably ILLEGAL COMMAND) back to 
your terminal. Generally, you are allowed as many chances to make a correct entry 
as are necessary. However, if you are unsuccessful at logging into the system four 
times in succession, your terminal is automatically disconnected. If this happens, 
merely recheck your assigned user number and password (if one is assigned), and 
start over. 

LOG-IN PROCEDURE 

1. Check to ensure that the following switches on the terminal are set to the 
correct position. Do not be alarmed if one or more of the switches listed 
do not exist on the terminal to be used. If the terminal has been deter- 
mined to be acceptable for KRONOS time-sharing operations, its use should 
correspond to that described in this manual. 

• Full-duplex/half-duplex (FDX/HDX) switch - Although this switch can 
be set to either position, it is normally set to the half-duplex position. 
If set to full-duplex, characters entered from the terminal are not 
printed. 

• Even parity/odd parity switch - If an ASCII code terminal is being used, 
this switch must be set to even parity. Odd parity must be selected 
for correspondence code terminals. 

« Baud rate switch - This switch determines the speed at which the 
terminal transmits and receives information. There is only one 
correct position when the terminal is connected to KRONOS. However, 
this is a system option and is dependent upon the system equipment 
being used. If you do not know the correct setting, consult your service 
vendor. 

2. Dial the KRONOS computer site. If the procedure is unfamiliar, refer to 
appendix B for complete instructions. When the connecting sequence is 
complete, KRONOS initiates the log-in sequence as follows: 

yy/mm/dd. hh. mm.ss 

KRONOS TIME-SHARING SYSTEM - VER. 2.1. 

USER NUMBER: 

Where: 

yy/mm/dd. Current date (year/month/day.) 
hh.mm. ss. Current time (hours, minutes, seconds.) 

If this information does not appear at the terminal, identification of the 
terminal is required. Correspondence code terminals must always be identi- 
fied. Specific ASCII code terminals may also require identification. | 
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3. Identify your terminal to KRONOS as follows (if identification is not required, 
proceed to step 4): 

« Correspondence code terminals with standard print 

Press the ATTN key 
Correspondence code terminals with APL print 

Type A and press the ATTN key 
« ASCII code terminals with standard print 

Type T 
• Memorex 1240 (ASCII code) terminals with APL print 

Type M 

The log-in sequence should be initiated automatically (as described in 
step 2) after the terminal is identified. 

4. Enter your assigned user number on the current line. 
For example: 

USER123 (c^ 

The system responds by printing: 

PASSWORD 
■■■■■■■■■ 

5. Enter your password in the blacked-out area. For example: 

ABCDEFG (C^ 

If no password has been established, type (Cly only. 

The system responds by printing either: 

TERMINAL: nnn, iii TERMINAL: nnn, iii 

RECOVER/CHARGE: °^ RECOVER/SYSTEM: 

Where: 

nnn Terminal number that the system uses as part of the unique 
identifier for each active user 

iii Identifier that describes the type of terminal as follows: 

TTY ASCII code terminal with standard print 

MEMAPL Memorex 1240 (ASCII code) terminal with APL print 

CORA PL Correspondence code terminal with APL print 

COR Correspondence code terminal with standard print 

6. Perform step a or b depending upon which system response was printed in 
step 5. 

a. If the RECOVER/SYSTEM: response was printed, enter the subsystem 
to be used on the same line (BASIC for this session). 

For example: 

BASIC (ci 
The system responds by printing: 

OLD, NEW, OR LIB FILE: 
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b. If the RECOVER/CHARGE: response was printed, type CHARGE, followed 
by your assigned charge number and project number on the same line. 
For example: 

CHARGE, chargeno,projectno K^R) 

The system responds by printing: 

READY. 
Then enter the subsystem to be used (BASIC for this session). 
For example: 

BASIC (cr) 
The system responds by printing: 

OLD, NEW, OR LIB FILE: 

7. Enter the appropriate file status on the same line (NEW for this session). 
For example: 

NEW (6r) 
The system responds by printing: 

FILE NAME: 

8. Enter the one to seven-character file name on the same line (PRIME for this I 
session). I 
For example: 

PRIME (c^ 

The system responds by printing: 

READY. 

To this point the output at the terminal has the following form. 

yy/mm/dd. hh.mm.ss. 

KRONOS TIME-SHARING SYSTEM - VER. 2. 1. 

USER NUMBER: USER123 

PASSWORD 

|A|B|C|D |E|F|G| UU " The password cannot be seen and is shown 

TERMINAL: nnn, iii in this manner solely for purposes of 

RECOVER /SYSTEM: BASIC illustration. 

OLD, NEW, OR LIB FILE: NEW 

FILE NAME: PRIME 

READY. 
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PROGRAM ENTRY AND EXECUTION 

1. Now enter the BASIC program PRIME. Each program statement is followed 
by a carriage return. 

10 PRINT "this is a LISTIi^G OF TEN PRIME NUMBERS*' 

1 1 PRINT 

20 PRI'^T "which prime THE PRIME NUMBER 

30 LET N=0 

40 LET V=0 

45 FOR A=1 TO 10 

50 LET V=V+1 

60 LET Y=INT(V/2+.5) 

70 FOR X=2 TO Y 

80 LET Z=V/X 

90 LET W=INT(Z) 

100 IF Z=W THEN 5 

1 1 NEXT X 

1 20 LET N=N+1 

140 print" ";N," ";V 

1 60 NEXT A 

170 END 



2. The program is now ready to be executed. Type: 
RUN ^^ 
The system returns the following output: 
yy/mm/dd. hh.mm.ss. 
PROGRAM PRIME 

THIS IS A LISTING OF TEN PRIME NUMBERS 

WHICH PRIME 
1 
2 
3 
4 
5 
6 
7 
8 
9 
10 



3. This program prints the first ten prime numbers. After the program has 
completed execution, the system replies: 

CP s.sss SECS. 

RUN COMPLETE. 

Where: 

s.sss Amount of central processor time required to execute the 

program 
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THE 


PRIME NUMBE 




1 




2 




3 




5 




7 




11 




13 




17 




19 




23 



LOG-OFF PROCEDURE 

To leave the system, type: 
BYE (C] 



This command causes the following informiation to be printed, then logs you off the 
system by disconnecting the terminal. 

USER123 LOG OFF. hh. mm. ss 

USER123 CP s.sss SEC. 

Where: 

s.sss Total central processor seconds used since log-in 

TIME OUT 

The system will log-off an inactive terminal if no entry is made within a 10-minute 
period. 
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FILE USAGE 



With the exception of some central memory tables, all data in the KRONOS system 
is considered either a file or a part of a file. This section describes the mass 
storage file organization under KRONOS and explains the fundamentals of file processing. 
Refer to the KRONOS Reference Manual for detailed information concerning the KRONOS 
file structure. 

FILE STRUCTURE 

A file is the largest collection of information addressable by name (one to seven I 

characters), and begins with the beginning- of- information (BOI), before which no data I 
exists. A file consists of one or more logical records of information. A logical 
record is a group of related words or characters, of fixed or variable length, which is 

independent of its physical environment. Thus, a logical record on punched cards I 

would contain the same information as its counterpart on mass storage. I 

The physical record unit (PRU) is the smallest division of data on a device. A PRU 
on all mass storage devices in the KRONOS system consists of 640 six-bit characters. 
The logical record is composed of one or more PRUs. 

The end of a logical record is the end-of-record (EOR). The end of a file is the end- 
of-information (EOI). The system automatically writes an EOI as the last physical 
item of information on all files. However, the user may have the additional capability 
to write an end-of-file mark (EOF) to signify the end of a file. This capability exists | 
in the FORTRAN subsystem and in other languages available under the BATCH sub- 
system (COMPASS, COBOL, etc. ). Therefore, due to the EOI concept, a file may 
actually be a multifile file. For example: 

(BOI). . . data. . . (EOR). . . data. . . (EOR)(EOF ). . . data. . . (EOR)(EOF)(EOI) 

A typical file is illustrated by the following example. 

One line of an invoice may form an item, a complete invoice may form a 
record, a set of such records may form a file, and the collection of invoice 
files may form a multifile file. 

To have a file positioned at the BOI means that a subsequent read operation will read 
the first logical record. A write operation writes data on the first PRU and terminates 
with an EOR and EOI following the logical record. A file positioned at EOR has the I 

following record, EOF, or EOI read on a subsequent read operation. A subsequent 
write operation on the file adds data to a new physical record following the current EOR 
or EOF. A file positioned at EOI is positioned at the last physical record of the file. 
Any subsequent read operation causes the EOI to be read. No data is transmitted. A 
write operation writes over the existing EOI and adds a new logical record to the file 
followed by an EOR and EOI. 
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The following examples illustrate possible positions within a file. 
File 



File 
File 



1 


. . . data. . . (EOR)(EOF)(EOI) 




m [2] lU l4i 


2 


. . . data. . . (FOR). . . data. . . (EOR)(EOF). . 




m m H 


3 


. . . data. . . (EORHEOI) 




QI [2] iiJ 


m 


File positioned at BOI 


[H 


File positioned at EOR 



[3] File positioned at EOF 
[4] File positioned at EOI 

WORKING FILES 

Generally, a working file is either a new file, created by the user, or a copy of a 
file that already exists in the system (indirect access permanent filet )• All working 
files are temporary in nature and can exist no longer than the user is logged into the 
system. Working files may be created, accessed, and released at the discretion of 
the user while he is logged into the system but they are automatically released when 
he logs off the system. 

Working files may also be referred to as local files. The parameter Ifn on most 
time -sharing job commands and permanent file commands (described in sections 4 and 
5) signifies a local file name. Therefore, throughout this manual, the terms are 
synonymous . 

One type of working file, the primary file, has special significance in certain time- 
sharing commands. A primary file is obtained with the OLD or LIBRARY command 
which retrieves a copy of an indirect access permanent file. In addition, a primary 
file is created with the NEW command. There is only one primary file active or 
available to the user at any given time. For example, the command 

OLD.LFNl 
retrieves a copy of indirect access permanent file LFNl from permanent file storage 
for use as the primary file. If the command 

OLD,LFN2 

is entered, a copy of indirect access permanent file LFN2 is retrieved for use as the 
primary file, and the current primary file (LFNl) is released. To access LFNl again, 
the user must enter the OLD command or enter: 

GET, LFNl 

If this command is used, a copy of permanent file LFNl is retrieved for use as a 
working file and the current primary file (LFN2) remains the same. 



tRefer to section 5 for complete information concerning permanent files. 
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Most operations performed on files by time-sharing terminal commands are performed 
using the primary file, unless another working file is specified in a command para- 
meter. For example, the command 

SAVE 
is used to retain the primary file in the permanent file system. However, the command 
SAVE, ABC 

is used to retain file ABC in the permanent file system. File ABC could be either the 
primary file or another working file. 

There is a close association between the primary file and the subsystem in use when 
the primary file is saved. Unless the NULL subsystem is active when the primary file 
is saved, an internal indicator called the subsystem flag is set to indicate which sub- 
system is being used. That subsystem becomes associated with the permanent file and 
is automatically selected each time the file is retrieved using the OLD command. For 
example, if a user currently operating under the BASIC subsystem issues the command 

SAVE, ABC 

where ABC is the current primary file name, the BASIC subsystem flag will be associated 
with the resulting permanent file ABC. If at a later date the user is operating under 
another subsystem and enters the command 

OLD, ABC 

the current primary file is released, the BASIC subsystem is selected automatically, 
and file ABC becomes the new primary file. To save the primary file without a sub- 
system association, the user must enter the NULL subsystem before issuing the SAVE 
command. Retrieving a file saved while under the NULL subsystem does not affect 
the subsystem currently being used. Furthermore, the subsystem flag is set only when 
saving the primary file. There is no subsystem association when working files other 
than the primary file. If the permanent file named in the command to select a new I 

primary file (OLD or LIBRARY) does not have a subsystem associated with it, the I 

subsystem currently being used remains in effect. | 

Following any operation on a primary file, the file is automatically rewound (positioned 
at BOI). However, the user is responsible for the position of all other working files 
because they are not automatically rewound following each operation. The REWIND 
command from a time-sharing terminal, the REWIND statement in FORTRAN, or the 
RESTORE statement in BASIC can be used to position a file to the BOI. 

Source code (program statements, text, or data) entered from the terminal keyboard 
is normally stored in the primary file. However, the user can also enter source code 
into any working file, including the primary file, or create new working files using 
the Text Editor. Refer to the Text Editor (EDIT) Reference Manual for additional 
information. 

FILE SORTING 

Each line of source code entered by the user must begin with a one-to ten-digit line 
number unless the source code is entered in text mode, t Leading zeros on line 
numbers are permissible but are not required (00120 and 120 are interchangeable). 
Line numbers with leading zeros can be intermixed with line numbers containing no 
leading zeros. Line numbers can be entered manually or may be generated auto- 
matically by the system. This is accomplished by entering the AUTO command (refer 
to description in section 4). Note that the line numbers generated by the AUTO 
command consist of only five digits. 



t Refer to the TEXT command in section 4 for information concerning text mode. 
60407600 B 3-3 



When the user is not in text mode, entering numbered lines of source code sets an 
internal indicator called the sort flag. When the sort flag is set, the primary file is 
sorted automatically whenever the LIST, LNH, RUN, RNH, LENGTH, EDIT, or SUBMIT 
command is entered. Sorting of the file places the statements in order according to 
the first five digits of the line number. If it is desired to sort the file on more than 
the first five digits, the number of digits can be specified using the SORT,lfn command 
(NC parameter). Refer to description of this command in section 4. 

When entering a program from the terming^, the user enters the line number and the 
statement. After the carriage return ( CR) ) key is pressed, the text is entered into 
an area in core. Periodically, when this^tfrea (16 decimal central memory words) is 
filled, the text is written to the user's primary file on mass storage as a new logical 
record. When a sort is performed, these records are rewritten as one logical record. 
Thus, the entire program is stored as one logical record. 

If the message 

FILE TOO LONG TO SORT. 

is returned to the user, the file is too long to be sorted automatically by the system. 
The user must then enter the SORT,lfn command before proceeding. 

However, if the message 

FILE NOT SORTED. 

is returned to the user, the system has attempted to sort the file but discovered that 
one or more lines begin with nonnumeric line numbers. Thus, a sort was not per- 
formed. The user may enter the SORT,lfn command for more informative diagnostics. 

If the user wishes to inhibit automatic sorting of the primary file, he may enter the 
NOSORT command. This command clears the sort flag and should be entered only 
when the user desires that the primary file not be sorted and packed into one logical 
record. The sort flag is reset' when KRONOS receives the first numbered line of 
source code following the NOSORT command. 

The following example illustrates the effect of the NOSORT command. The user 
selects the proper subsystem and obtains a copy of permanent file A with the command 
sequence: 

FORTRAN, OLD, A 

It should be noted that if file A had a subsystem flag other than FORTRAN or NULL 
associated with it, that subsystem would be selected automatically even though the 
user specified the FORTRAN subsystem. To ensure that the correct subsystem and 
file have been selected, the user enters the command: 

STATUS 

The system prints the following status report. 

TERMINAL 42, TTY«« Identifies the terminal being used 

SYSTEM - FORTRAN Proper subsystem was selected 

FILE NAME: A -— File A is the new primary file 

STATUS - IDLE 

The user then requests a listing of the file with the command: 
LIST 



3-4 60407600 A 



The system prints the following copy of the file. 

73/01/10. 16.07.14. 

PROGRAM A 

00100 PROGRAM TEST (OUTPUT) 

00110 DO 1 J=l, 10 

00120 PRINT, J 

00130 1 CONTINUE 

00140 END 

READY. 

The user then enters the following changes: 

00120 K=J>:a 
00130 PRINT, K 
00140 1 CONTINUE 
00150 END 

and enters the command: 
NO SORT 

The system responds: 
READY. 

The user then calls for a listing with logical record indications by entering: 

LIST,R 
The system lists the unsorted file indicating the end of each logical record. 

73/01/10. 16.12.23. 

PROGRAM A 

00100 PROGRAM TEST (OUTPUT) 

00110 DO 1 J = l, 10 

00120 PRINT, J 

00130 1 CONTINUE 

00140 END 

--EOR-- 

00120 K=J*J 

00130 PRINT, K 

00140 1 CONTINUE 

00150 END 

--EOR-- 

READY. 

If the user had requested a listing without entering the NOSORT command, the following 
output would have been provided. 

73/01/10. 16.12.23. 

PROGRAM A 

00100 PROGRAM TEST (OUTPUT) 

00110 DO 1 J = l,10 

00120 K=J*J 

00130 PRINT, K 

00140 1 CONTINUE 

00150 END 

--EOR-- 
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If the user wishes to inhibit file sorting, but desires that the file be packed into one 
logical record, he may enter the following command. 

PACK 

If the user then wishes to perform text editing on the packed file, he can call the Text 
Editor with the EDIT command (refer to the description of the EDIT command in section 
4). 

WORKING FILE CONTROL 

As mentioned previously, the OLD, NEW, and LIBRARY commands change the status 
of files by exchanging the current primary file for another. When the OLD command 
is entered, the primary file is exchanged for a copy of an indirect access permanent 
file from the permanent file system. When the NEW command is entered, the 
primary file is exchanged for a primary file which the user enters from the terminal. 
The LIBRARY command replaces the current primary file with a copy of an indirect 
access permanent file saved under the special user number LIBRARY. 

It is important to note that normally, when the current primary file is released (by entry 
of the OLD, NEW, or LIBRARY command), all other working files are also released 
when the next command is entered, unless that command is NODROP. The current work- 
ing files are retained if the next command entered is NODROP. 



The following is a list of sample commands and their effect on files. The example 
assumes that there is no subsystem association with any file retrieved using the OLD 
command. Therefore, the subsystem to be used must be specified, if other than the 
current subsystem. 

Files Present at Completion of Command 



Commands 



Primary 



RUN 



COMPLETE, (system response) 



GET,B1 

GET, CI 

SAVE, TAPE 1 

FORTRAN, OLD, A2 

NODROP 

RUN (program A2 creates TAPE2; 



Other Working Ji-iles 



BASIC, OLD, A 






A 




GET.B 






A 


B 


GET,C 






A 


B,C 


GET,D 






A 


B,C,D 


FORTRAN, OLD, A 1 






Al 


B,C,D 


RUN (program Al 


creates 


TAPED 


Al 





Al TAPEl 

Al TAPEl, Bl 

Al TAPEl, Bl, CI 

Al TAPEl, Bl, CI 

A2 TAPEl, Bl, CI 

A2 TAPEl, Bl, CI 

A2 TAPEl, Bl, CI 



RUN COMPLETE, (system response) 



A2 



TAPEl, TAPE2,B1,C1 



3-6 
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other commands that change the status of working files are 
CLEAR 



LOGIN 

HELLO 

GOODBYE 

BYE 



Releases all working files. Note that only the contents of 
the current primary file is released; the primary file name 
is retained. If no primary file is currently specified, a new 
primary file name is requested. 

Releases all working files 

Releases all working files 

Releases all working files 

Releases all working files 



Refer to section 4 for a complete description of these commands. 
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SYSTEM COMMANDS 



After the user has successfully logged into the system, he can enter the commands 
necessary to process his job. There are four general categories of commands 
available to the user. 

« Terminal control commands 

« Subsystem selection commands 

« Job processing commands 

« Permanent file commands 

With the exception of permanent file commands, each command category is described 
in this section. Permanent file commands are described in section 5. 

COMMAND PROCESSING 

The minimum number of characters required to specify a command depends upon the 
specific command and the subsystem currently being used. A minimum of three 
characters are checked when a command is entered in all subsystems except the BATCH 
subsystem. In the BATCH subsystem, commands cannot be abbreviated. If more than 
the minimum number of characters are entered, the system checks the number given, 
up to a maximum of seven characters. 

For example, if a user is operating under the BASIC subsystem and wishes to change 
to FORTRAN, the following would be legal and illegal commands for entering FORTRAN. 

Legal Forms Illegal Forms 

FOR F 

FORT FO 

FORTR FORx 

FORTRA (where x is any alphanumeric 

FORTRAN character except T) 

However, if the user is in the BATCH subsystem and wishes to change to any other 
subsystem, the name of that subsystem must be entered without abbreviation. 

In general, KRONOS processes each command by checking from one to seven of the 
characters entered. If the user does not enter a sufficient number of characters to 
make the command unique, the system responds 

COMMAND NOT UNIQUE. 

and the user must then reenter the command using a sufficient number of characters 
to make it unique. This only occurs with commands in which several characters are 
identical, such as HELP and HELLO. In this case, HEL would result in the command 
being declared not unique. 
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If the command entered is not a valid command or has been misspelled, the message 
ILLEGAL COMMAND. 

is returned. When the juser discovers an error in the command or other input before 
the carriage return ( cg ) key is pressed, he may either delete the entire line or 
backspace to the point oithe error, correct it, and continue on the same line. 

To delete a line, simply press the ESC or ESCAPE key (ASCII code terminals) or ATTN 
key (correspondence code terminals). The system responds 

*DEL* 
and then positions the carriage to the first character position of the next line. 

To backspace and correct a line, count the number of characters (including spaces) 
past the position of the error and press the backspace key an equal number of times. 
Then correct the error and continue on the same line. The backspace key on ASCII 
code terminals is the underline (_) key.t On correspondence code terminals, the 
BACK SPACE key is used. 

If the user attempts to perform an operation for which he is not validated or exceeds 
his validation limits, the system responds: 

ILLEGAL USER ACCESS. 

The system maintains validation controls for every user number. Refer to the LIMITS 
command at the end of this section for a complete description. 

Alphabetic characters entered in lowercase are automatically translated to uppercase 
unless the ASCII command is in effect. The ASCII command inhibits translation from 
lowercase to uppercase (refer to the description of the ASCII command). Note that 
all commands may be entered in uppercase or lowercase in either ASCII or non-ASCII 
naode. 

On all commands that require a numeric value, the number is treated as follows: 

• If the number contains an eight or nine, decimal base is assumed. 

• The base may be specified by a post radix of B or D, that is, 562D is 
treated as 562 decimal and 562B is treated as 562 octal. 

• Default conversion of numbers is normally to base octal although this is 
a system option. 

TERMINAL CONTROL COMMANDS 

The terminal control commands allow the user to vary the source and format of 
information given to and received from the system. These commands, which may be 
entered at any time after the user has successfully logged in, are described as follows: 
p,SCll Provides capability to use the full ASCII or correspondence 

code set. This command specifies that subsequent characters 
entered from the terminal will be translated into an extended 
internal character set consisting of 128 characters. The 
standard internal character set contains only the first 61 of 
these characters. (Character sets are listed in appendix B. ) 



tThe backspace character on Teletype model 33/35 terminals is the shift-0 key. 
The character may be either an underline (_) or a left arrow (-^ )• 
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AUTO,nnnnn, iiii 



KRONOS recognizes all characters of the full ASCII code set 
except LINE FEED and the ASCII-DEL codes. Input control 
characters (return, delete, and backspace) are recognized but 
are not translated. Characters of the standard code set are 
processed internally as six-bit display code characters. The 
additional characters which make up the full ASCII code set 
are processed internally as 12 -bit display code characters 
with an escape code convention. Refer to appendix B for an 
explanation of how the system interprets characters in both 
ASCII and non-ASCII modes. 

The ASCII command must be entered if lowercase letters are 
to be interpreted as such by the system. Normally, all lower- 
case letters are translated to uppercase. Commands may be 
entered in uppercase or lowercase in either ASCII or non- 
ASCII mode. 

NOTE 

If a correspondence code terminal 
is being used, the ASCII command 
must be entered to enable use of 
the full correspondence code set. 

Causes generation of five-digit line' numbers automatically. 
The nnnnn parameter specifies the beginning line number; 
default value is 00100. The iiii parameter specifies the 
increment value added for each succeeding line number; 
default value is 10. The user can exit from auto mode by 
using either of the following methods. 

1. Delete the current line by pressing the ESC or 
ESCAPE key (ASCII code compatible terminals) 
or ATTN key (correspondence code terminals) 
and then enter a new command on the next line. 

2. Backspace six character positions and then enter a 
new command on the same line (six backspaces 

are required to overwrite the five-digit line number 
and the blank that follows). 

It is also possible to alter the line numbering sequence by 
deleting or backspacing (steps 1 or 2) and then entering a 
new beginning line number rather than a new command (leading 
zeros are permissible but not required). The user should exer- 
cise caution when doing this since the AUTO command is still 
in effect and continues generating line numbers using the original 
increment value. Thus, if a line number is generated that al- 
ready exists in the file, the contents of that line are lost and 
must be entered again to be retained. Note that it is not 
possible to alter the increment value unless a new AUTO com- 
mand is entered. 

In the following example of the AUTO command, the user back- 
spaces over the line number and enters an LNH command (refer 
to Time-Sharing Job Commands in this section for a description 
of the LNH command). 
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AUTO 

00100 TfflS IS A TEST 

00110 FOR THE AUTO COMMAND 

00120 END 

00130 LNH 

00100 THIS IS A TEST 

00110 FOR THE AUTO COMMAND 

00120 END 

READY. 

In the following example, the user backspaces to change the num- 
bering sequence and later deletes a line to change the numbering 
sequence. 

NEW,KL 
READY. 

AUTO, 10, 10 

00010 THIS IS A TEST 

00020 FOR THE AUTO COMMAND 

00030 00100 TEST 

00110 TEST 
00120 *DEL* 
00200 TEST 
00210 END 
00220 *DEL* 
LNH 

00010 THIS IS A TEST 

00020 FOR THE AUTO COMMAND 

00100 TEST 

00110 TEST 

00200 TEST 

00210 END 

READY. 

FULL Enters full-duplex mode. Under this mode, each character re- 

ceived by the system is echoed back to the terminal just as it 
was received. This mode is effective only for terminals which 
have a full-duplex capability. The system responds: 

READY. 

If the half/full duplex switch on the terminal is in the half- 
duplex position when this command is entered, each subsequent 
character entered is double printed (initially when it is typed, 
and again when it is echoed back by the system). Placing this 
switch in the full-duplex position allows only the character 
echoed back to the terminal to be printed. 

HALF Clears full-duplex mode (refer to FULL command). Characters 

received by the system after this command is issued are not 
echoed back to the terminal. The system responds: 

READY. 

If the terminal being used has a half/full duplex switch, char- 
acters entered at the terminal are not printed when the switch 
is in the full-duplex position. Only system-generated output 
appears at the terminal. Placing this switch in the half-duplex 
position enables keyboard entry to be printed. 
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NORMAL 



PARITY 



ROUT, nn 



TAPE 



TERM,t 



Reverses the effect of the ASCII, AUTO, PARITY, and TAPE 
commands. KRONOS initially assumes that this command has 
been entered. Normal mode consists of a 61 -character code 
set where all lowercase letters are converted to uppercase. 

Specifies that all subsequent output to an ASCII code terminal 
be transmitted in odd parity, and all output to a correspondence 
code terminal be transmitted in even parity. KRONOS initially 
assumes that all information is transmitted in even parity to 
ASCII code terminals and odd parity to correspondence code 
terminals. 

Sets the amount of time required to perform the return function 
(carriage return and line feed) for an ASCII code terminal. This 
command is not valid for correspondence code terminals. The 
nn parameter specifies a character count delay. This is the 
amount of time required by the system to s end nn characters to 
the terminal, where the value of nn can range from to 30. If 
zero is specified, a standard delay value is used. The system 
responds: 

READY. 

This command is necessary since the length of time required 
for the return operation varies depending upon the type of 
terminal being used. For example, if the system is trans- 
mitting output to a terminal, a fixed amount of time is allowed 
for the return function, after which the system sends the next 
line of output. If the amount of time is not sufficient, char- 
acters may be printed during the carriage return function. 

The delay is accomplished by sending rubout characters for 
paper tape operations and null characters for all other input/ 
output operations. The number of characters to be sent is 
initially set at log-in or recovery time by the system. If 
a ROUT command is entered, the number of characters specified 
for the delay remain in effect until termination of the session 
(log-off), recovery, or until another ROUT command is entered. 

Permits subsequent information to be read from the paper tape 
reader at an ASCII code terminal. The system sends an X-ON 
character to the terminal at the end of each program request 
for data and after execution of each command. The X-ON 
character is used to turn on the paper tape reader at the 
user's terminal. This mode also inhibits the output of header 
messages and the READY message when the LIST or LNH 
command is entered. The user should note that the system 
ignores carriage return characters entered on an empty input 
line while in tape mode. Refer to appendix C for complete in- 
formation concerning paper tape operations. 

Sets the terminal type to indicate standard or A PL print. 

t Specifies terminal and print type 

TTY ASCII code terminal with standard print 

MEMAPL Memorex 1240 (ASCII code) terminal 
with A PL print 

CORA PL Correspondence code terminal with APL 
print 

COR Correspondence code terminal with standard 

print 



60407600 A 



4-5 



This command is useful only for terminals capable of having 
either standard or APL print. The user can change the print 
type and then indicate the change by means of the TERM com- 
mand. 

For example, a user operating a Memorex 1240 terminal changes 
the print type from standard to APL. To notify the system, 
he enters: 



TERM, MEMAPL (S| 



NOTE 

All ASCII code terminals with standard print 
are designated TTY. The Memorex 1240 is 
an ASCII code terminal and therefore is iden- 
tified as TTY when using standard print. 

SUBSYSTEM SELECTION COMMANDS 

The following commands are used to select a specific subsystem. The user should 
always be aware of the subsystem that is currently active. For example, attempting 
to execute a FORTRAN program while operating under the BASIC subsystem causes 
meaningless diagnostic messages to be issued. To determine which subsystem is 
currently active, enter the STATUS command. 

When a user enters the SAVE command to retain his primary file in the permanent 
file system, it is especially important that he is aware of which subsystem is currently 
active. An internal indicator called the subsystem flag associates the current sub- 
system with the primary file being saved. Thus, each subsequent request for that file 
using the OLD command causes the associated subsystem to be selected automatically. 
To save the primary file with no Subsystem association, the user must enter bi^c j-^v^j^j^ 
subsystem before he issues the SAVE command. Note that the subsystem flag has 
meaning only when saving the primary file. When saving working files other than the 
primary file, no subsystem association is made. 

BASIC, ccc Selects the BASIC subsystem. The ccc parameter is optional 

and enables the user to specify an additional command. Al- 
though any valid command is permitted (as well as all valid 
parameters for that command), only one additional command 
may be specified. The following example illustrates the use 
of this option. 

BASIC, OLD, PRIME 

In this example, the user selects the BASIC subsystem and 
the OLD file PRIME in one command. Note that the file name 
(PRIME) is a valid parameter with the OLD command. 

If ccc is omitted, and no primary file is currently defined, 
the system responds: 

OLD, NEW, OR LIB FILE:t 

The user may then specify the file type and the file name 
(separated by a comma) followed by a ^w . If the file name 
is omitted in the reply, the system respOTds: 

FILE NAME: 

The user then specifies the file name followed by a fcR) . 

tLIB is an abbreviation of the command LIBRARY. Refer to the description of this 
command later in this section. 
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BATCH, nnnnn Selects the BATCH subsystem. The nnnnn parameter specifies 

the field length in octal central memory words required for 
control card images to be entered. If nnnnn is not specified, 
a default value of 20000B is assumed. The system responds: 

$RFL, nnnnn. (nnnnn is the specified field length. ) 

The user may then enter control card images, time-sharing 
commands, or both for the job. Refer to the KRONOS Reference 
Manual for information concerning control cards. 

It is important to note that the time -s bring commands and 
control card images entered are not processed as a batch job. 
as the subsystem name implies. Instead, each control card 
or command is entered and processed individually. The sub- 
system is named BATCH because images of control cards, 
usually referred to as batch control cards, are able to be 
processed. Refer to section 9 for a complete description of 
the BATCH subsystem. 

EXECUTE, ccc Selects the EXECUTE subsystem. This subsystem is used only 

to execute a previously compiled (object code) program. The 
RUN (or RNH) command must be entered to initiate execution. 
The ccc parameter is optional and enables the user to specify 
an additional command. Although any valid command is per- 
mitted (as well as all valid parameters for that command), 
only one additional command may be specified. The following 
example illustrates the use of this option. 

EXECUTE, OLD, OBJFILE 

In this example, the user selects the EXECUTE subsystem and 
the OLD file OBJFILE in one command. Note that the file name 
(OBJFILE) is a valid parameter with the OLD command. 

If ccc is omitted and no primary file is currently defined, the 
system responds: 

OLD, NEW, OR LIB FILE:t 

The user may then specify the file type and the file name 
(separated by a comma) followed by a (6^ . If the file name 
is omitted in the reply, the system responds: 

FILE NAME: 
The user then specifies the file name followed by a (c5) 

NOTE 

Source language programs cannot be 
executed under the EXECUTE subsystem. 

The EXECUTE subsystem should be used whenever possible to 
improve time-sharing efficiency. This can be achieved when 
certain programs are used frequently. For example, a source 
code program created under the FORTRAN subsystem must 
first be compiled before it can be executed. This process is 
automatic. The user needs only to enter the RUN command. 



tLIB is an abbreviation of the command LIBRARY. Refer to the description of this 
command later in this section. 
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The program automatically goes through a compilation phase 
which produces an executable object code (binary) program* 
The object code program is then executed. From this, it can 
be seen that retaining the object code program in the permanent 
file system for later execution under the EXECUTE subsystem 
provides greater efficiency. This can be accomplished through 
use of the RUN,B=lfn command. This command causes the 
object code program to be placed on a working file (Ifn) speci- 
fied by the user. That file is then retained in the permanent 
file system by entering the command SAVE,lfn. 

Note that since the file containing the object code is not the 
primary file, a subsystem flag is not associated with the file 
when it is saved. In this case, the EXECUTE subsystem will 
not be selected automatically when the file is requested using 
the OLD command. The user must ensure that the EXECUTE 
subsystem has been selected before attempting to execute the 
program. 

To associate the EXECUTE subsystem with the file contaj.ning 
the object code program, enter the following commands, 

EXECUTE, NEW, Ifn Selects the EXECUTE subsystem and 

specifies a new primary file name 
(Ifn) 

NODROP Prevents the working file contain- 

ing the object code program from 
being released 

SAVE Retains the primary file in the 

permanent file system and sets 
the EXECUTE subsystem flag. The 
file contains no information at this 
point. 

REPLACE, If n=pfn Copies the contents of the working 

file containing the object code 
program (Ifn) to the permanent file 
created with the SAVE command 
(pfn). This command can be entered 
regardless of the subsystem current- 
ly being used. It has no effect on 
the EXECUTE subsystem Hag asso- 
ciated with file pfn. 

If this is done, subsequent requests to the file using the OLD 
command cause the EXECUTE subsystem to be selected. Entering 
the RUN command initiates execution of the object code program. 

FORTRAN, ccc Selects the FORTRAN subsystem. The ccc parameter is op- 

tional and enables the user to specify an additional comnaand. 
Although any valid command is permitted (as well; i as all valid 
parameters for that command), only one additional command 
may be specified. The following example illustrates the use 
of this option. 

FORTRAN, OLD,DATAGEN 

In this example, the user selects the FORTRAN subsystem and 
the OLD file DATAGEN in one command. Note that the file 
name (DATAGEN) is a valid parameter with the OLD command. 
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If ccc is omitted and no primary file is currently defined, 
the system responds: 

OLD, NEW, OR LIB FILE:t 

The user may then specify the file type and file name 
(separated by a comma) followed by a CR . If the file 
name is omitted in the reply, the systenT^esponds: 

FILE NAME: 



The user then specifies the file name followed by a (CI« . 

NULL Clears the subsystem currently in use. The system responds: 

READY. 

This command is entered before saving the primary file if 
the user does not want a specific subsystem flag to be as- 
sociated with the file. Normally, when a user saves the 
primary file, an internal indicator called the subsystem flag 
is set to indicate the subsystem currently in use. That sub- 
system is automatically selected in each succeeding request 
for the file using the OLD command. Note that there is no 
subsystem association when saving working files other than the 
primary files. 

If the user does not specify a subsystem at log-in time, the 
system assumes NULL by default. 

TIME-SHARING JOB COMMANDS 

The time- sharing job commands allow the user to perform a variety of job processing 
or job related operations. These commands may be entered at any time after the 
log-in procedure is complete. 

APL,t Selects the APL (A Programming Language) interactive inter- 

preter. This command also specifies translation to the full 
12 8- character code set. All characters are recognized al- 
though input control characters are not processed. Rather, 
they are passed to the program as data. The t parameter is 
optional and identifies the type of terminal being used. Refer 
to the KRONOS APL>;CYBER Reference Manual for a list of 
terminal identifiers and information concerning the use of APL. 



tLIB is an abbreviation of the command LIBRARY. Refer to the description of this 
command later in this section. 
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BINARY, nnnn,ccc Selects binary input mode. Under control of this command, 
eight-bit characters entered from the terminal are stored, 
without translation, in the primary file. Normally, char- 
acters entered from the terminal are translated and stored as 
6-bit or 12 -bit internal display codes (refer to Central Memory 
Character Equivalents in appendix B for complete information). 

nnnn Number of characters (1 to 4095) to be entered 

ccc Termination character; a three-digit octal code that 
corresponds to a character which the user selects 
to terminate binary input mode. Refer to appendix 
B for the correct character set and corresponding 
codes. (If a correspondence code terminal is being 
used, a value of 200 must be added to the octal 
code listed in appendix B. ) 

The termination character enables the user to re- 
turn to the normal input mode before the number of 
characters specified by nnnn has been entered. 

Example: 

BINARY, 20, 207 

In this example, binary input mode is terminated when 20 
characters have been entered or the ASCII character BELL 
(corresponds to octal code 207 entered in command) is typed. 

NOTE 

If the termination character (ccc) is 
omitted, the number of characters 
specified by nnnn must be entered to 
terminate binary input mode. 

BYE Logs the user off the system and disconnects the terminal. 

The system responds by printing: 

usernum LOGOFF. hh.mm. ss. 

usernum CP s.sss SEC. 

Where: 

usernum User number 

hh.mm.ss. Time of day this command was entered 

s.sss Total central processor time used since 

log-in 

NOTE 

The user should make certain that all working 
files to be retained are made permanent before 
issuing this command. All working files not 
saved are released when the BYE command is 
processed. 
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CHARGE, char geno. This command allows the user to specify a valid charge 
projectno number and project number to be billed for subsequent 

terminal operations. Although certain users are required 
to enter a charge and project number during the log-in 
sequence, all users may issue the CHARGE command as 
long as the charge and project numbers entered are valid. 
This command can be entered at any time during the time- 
sharing session. Both charge number (chargeno) and project 
number (projectno) parameters are required. The system 
responds: 



CLEAR 



DAYFILE 



EDIT, If n 



GOODBYE 
HELLO 



READY. 

Releases all working files. Only the name of the primary file is 
retained. If no primary file is currently specified, a new primary 
file name is requested. The system responds to entry of the CLEArI 
command with: 

READY. 

All files to be retained must be made permanent before entering 
this command. 

Prints the system's record of the user's time-sharing activity. 
Each line of output returned to the terminal is in the form 



hh. mm.ss. message 



Where: 

hh. mm.ss. Time of day the message was placed in 

the day file 

Selects the KRONOS Text Editor. The Ifn parameter specifies 
the name of an existing working file to be edited. The Ifn 
parameter may also specify a new working file name. In this 
case, the new file is constructed using the Text Editor. If 
the Ifn parameter is omitted, the primary file name is assumed. 
When necessary, the primary file is sorted prior to the 
initiation of text editing. 

All working files consisting of several logical records should 
be compressed into one logical record before entering this 
command (refer to PACK command described in this section). 
If this is not done, the contents of all but the first logical 
record is lost. For additional information, refer to the Text 
Editor (EDIT) Reference Manual. 

Same as BYE command 

Logs the current user off the system, as in the BYE command, 
and reinitiates the log-in sequence. Any working files that 
are to be retained must be made permanent before the HELLO 
command is entered. This command allows a new user to 
log-in without first having to establish communications with the 
KRONOS system by dialing the computer site. 
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HELP Allows the time-sharing user to obtain assistance in the use of 

KRONOS commands. If the user at a terminal is not sure of 
the format of a command or its use, the HELP command pro- 
vides an easily accessible on-line description of the KRONOS 
command set. The system responds by printing: 

IF MORE INFORMATION NEEDED, TYPE YES. OTHER- 
WISE, TYPE THE COMMAND NEEDED. 
? 

The user then types YES in reply to the request or else enters 
the command he wishes to have described. A minimum of three 
characters must be entered if a command is typed. The user 
must type END after a question mark (?) to terminate the HELP 
command. 

I key Interrupts a program that is currently transmitting output to the 

terminal. The system responds: 

^^INTERRUPTED- 

The user must press the @ key or type P followed by (qb} 
to continue. However, if the TAPE command is in effect (tape 
mode), CR) cannot be eMered as the first character of a new 
line. In rnis case, P (CH must be entered to continue. Refer 
to Job Suspension in secEion 7 for additional information. 

Use of the I key to perform this function is effective only for 
ASCII code terminals. The ATTN key can be used to perform 
the same function on correspondence code terminals (refer to 
Table B-1 in appendix B for complete information concerning the 
use of special function keys for both ASCII and correspondence 
code terminals). 

if pressing the I key accidentally disconnects the Leriiiinal froni 
the system, the user can log-in again and enter the RECOVER 
command in response to the RECOVER/SYSTEM: or RECOVER/ 
CHARGE: request. He can then continue from the point at 
which he was disconnected. Refer to Recovery in section 7 for 
additional information. 

LENGTH, Ifn Prints the file name, file type, last status, and length of 

the working file specified by Ifn. If the Ifn parameter is 
omitted, the primary file is assumed. In this case, the pri- 
mary file is sorted before the length is obtained, unless a 
NOSORT command precedes the LENGTH command (refer to 
description of NOSORT command in this section). 

The system responds: 

FILENAM TYPE STAT LENGTH UNIT 

Ifn .tt xxxx y-yyy kpr. 

Where: 

Ifn Local (working) file name 

.tt File type 

. PM Direct access permanent file 

. PT Primary working file 

.LO Any working file that is not the 
current primary file or a direct 
access permanent file 
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LIBRARY 



LIBRARY, If n= 
pfn/ options 



LIMITS 



The three following file types appear only 
if the user is in the BATCH subsystem. 

. CM Common file 



.LI 
.SY 



Library file 
System file 



xxxx 



y-yyy 



An - preceding the file type indicates a locked 
file (user cannot write onto a locked file). 

Working file status. Refer to KRONOS Reference 
Manual for description of status codes. 

Length of file in kilo physical record (KPR) 
units. A KPR is equal to 1000 physical record 
units (PRUs). A PRU contains 640 six-bit 
characters. 



Example: 

LENGTH, DIRFILE (C 
FILENAME TYPE 

DIRFILE =i^PM 



STAT 
0051 



"(user enters command) 
LENGTH UNIT 

0.019 KPR. 



Allows a user to access a file that was previously saved in 
the permanent file system under special user number LIBRARY. 
The system responds: 

FILE NAME: 

The user then enters the selected file name. When the file 
is found, the system replies: 

READY. 

The file selected becomes the new primary file and all current 
working files (if any) are released unless the NODROP command 
immediately follows this command sequence. Special considera- 
tions in the use of this command are described at the end of 
section 5. 

This is an optional form of the preceding command. It allows 
the user to specify the command LIBRARY, the selected file 
name, and special options on the same line. Refer to the 
command description in section 5 for information concerning I 
this command format. Special considerations in the use of 
this command are described separately at the end of section 5. 

Provides a listing of the user's current validation limits. 
Refer to Limits Command at the end of this section for a 
complete description of this command and a sample listing. 
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LIST,xxxxx,R, 

F=lfn 



Prints the contents of the primary file at the terminal unless 
the F option is specified. The primary file is automatically 
sorted before listing unless a NOSORT command precedes this 
command (refer to description of NOSORT command in this 
section). 

XXX XX Line number of the line where listing is to 

begin. This parameter is optional and may be 
specified only if the primary file is being 
listed. 

R End-of-record and end-of-file marks are to be 

indicated in the listing if present (optional). 
This lists the primary file from the beginning 
to the end-of-information unless the xxxxx 
parameter is specified. 

F=lfn Lists working file Ifn (optional). The file is 

not sorted before listing. When this parameter 
is specified, neither the xxxxx nor the R option 
can be supplied. The working file specified is 
listed from the current position to the end-of- 
information. 



The system replies: 

yy/mm/dd. hh. mm 

PROGRAM nnnnnnn 



. ss. \ 



header 



(program lines) 



LNH, xxxxx, R, 
F=lfn 

LOGIN 

NEW 



NEW, Ifn 



READY. 

The header information printed is: 

yy/mm/dd. Current date 

hh. mm.ss. Current time 

nnnnnnn File name 

This is an optional form of the preceding command which lists 
the file without a header. 

Same as HELLO command 

Allows the user to create a new primary file. The system 
responds: 

FILE NAME: 

The user enters a valid file name. When the system accepts 
the new file name, it replies: 

READY. 

The file name specified becomes the new primary file and all 
current working files are released unless NODROP is the next 
command entered. 

This is an optional form of the preceding command which allows 
the user to specify NEW and the file name in one step. 
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NODROP 



NOSORT 



OLD 



OLD,lfn=pfn/ 
options 



PACK,lfn., 
lfn2,NR 



Prevents the system from releasing current working files when 
the user issues the OLD, NEW, or LIBRARY command to I 

obtain a new primary file. This command must be entered 
immediately after the OLD, NEW, or LIBRARY command | 

sequence is complete. The system responds: 

READY. 

Refer to Working File Control in section 3 for an example of 
this command. 

Prevents the system from automatically sorting the primary file. 
This is done by clearing an internal indicator called the sort 
flag. Sorting of the primary file is initiated only if the sort 
flag is set when the LIST, RUN, EDIT, LENGTH, or SUBMIT 
command is entered. The system responds: 

READY. 

This command is generally used when making additions and /or 
modifications to the primary file. When followed by the NO- 
SORT command, the additions and /or modifications create a 
new logical record in the primary file. Note that the NOSORT 
command remains in effect only until the next numbered line 
of source code is entered. This causes the sort flag to be 
turned on again. Refer to the description of file sorting in 
section 3 for an example which illustrates the effect of the 
NOSORT command. 

Allows the user to access a file that was previously saved in 
the permanent file system. The system responds: 

FILE NAME: 



The user then enters the selected file name, 
found, the system replies: 

READY. 



When the file is 



The selected file becomes the new primary file. If a specific 
subsystem is associated with the file, it is selected auto- 
matically. This occurs only if the file was originally the 
primary file and was saved while a subsystem other than NULL 
was active. All working files are released following entry of 
this command unless the next command entered is NODROP. 

This is a special form of the preceding command. It allows 
the user to specify the command OLD, the file name, and 
special options on the same line. Refer to the command de- 
scription in section 5 for information concerning this command 
format. 

Compresses (that is, packs) a file consisting of several logical 
records into one logical record. When the operation is com- 
plete, the system responds: 

READY. 
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PASSWOR, 

oldpswd, 

newpswd 



RECOVER 



RENAME, Ifn, 
Ifno 



RESEQ 



The PACK command may be entered in one of the four following 
formats depending upon the options selected. 



PACK 



PACK, If n 



PACK,lfni, 
Ifno 



PACK,lfni, 
lfn2,NR 



Packs the primary file into one logical 
record. When the primary file is packed, 
it is not sorted automatically by subsequent 
operations that normally cause the file to 
be sorted (that is, LIST, RUN, etc. ). 
Automatic sorting resumes when the user 
enters the next line of source code or the 
SORT command. 

Rewinds and packs working file Ifn into 
one logical record. File Ifn is rewound 
again after the pack. 

Rewinds and packs working file Ifn^ into 
one logical record and then writes the 
file to lfn2. If lfn2 currently exists, Ifni 
is written at the current position of Ifno. 
File lfn2 is rewound after the pack; Ifnj 
is not. 

Same as the preceding format, except that 
the no rewind (NR) parameter inhibits file 
Ifn^ from being rewound before the pack, 
unless it is the primary file. The primary 
file is rewound after all operations. 



Allows validated users to change their password. The user 
must supply the correct current password (oldpswd) and a one- 
to seven- character, alphanumeric, new password (newpswd). 



J.X ci."y 



\ov»+ r^f +V|-lo r»r\n 



in Ckr»r»/-\r» +V»i 



a\TC!-ta,Tyt T»o-r>li 



ERROR IN PASSWORD ARGUMENTS. 



After the password has been changed, the system replies: 

READY. 

If the user is not validated to use this command, the system 
responds: 

ILLEGAL CONTROL CARD. 

Enables the time-sharing terminal user to resume processing 
after having been accidentally disconnected from the system 
or when a system malfunction requires that the log-in sequence 
be reinitiated. Refer to Recovery in section 7 for a com- 
plete description and examples of the use of this command. 

Changes the name of working file lfn2 to file name Ifnj^. If 
file Ifni currently exists, it is released. This command can- 
not be used to change the name of a permanent file. However, 
a working file can be renamed and then saved in the permanent 
file system under the new name. 

This command enables the user to resequence the line numbers 
of the primary file. If the current primary file is a text 
file, line numbers can be added. Statements that reference 
line numbers are updated when BASIC programs are resequenced. 
Refer to Resequencing Line Numbers in section 7 for a complete 
description and examples of the use of this command. 
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RETURN, Ifn 
REWIND, If n 

RUN 



Releases working file Ifn 

Positions working file Ifn at the beginning-of-information 
(BOD. Refer to File Structure in section 3 for additional 
information. 

Compiles and /or initiates execution of the primary file or 
another working file. The primary file is sorted before being 
compiled unless a NOSORT command precedes this command 
(refer to description of NOSORT command in this section). 
The system responds: 

yy/mm/dd. hh.mm.ss. 

PRO GR A M nnnnnnn 



header 



(data or error messages) 



CP 



s.sss SECS. 



RUN COMPLETE. 

One or more of the following options may be supplied with the 
RUN command. 



RUN,B=lfn 

or 
RUN,C=lfn 



Compiles the source program and 
generates a binary file containing 
the resultant object code on file Ifn. 
The source program is not executed. 
File Ifn can later be executed under 
the EXECUTE subsystem by entering 
the RUN command. File Ifn can be 
retained as a permanent file using the 
SAVE (or REPLACE command). 

Compiles and/or initiates execution of the 
working file Ifn (Ifn is assumed to be sorted), 
In the EXECUTE subsystem, no compilation 
occurs. 

RUN, MA =nnnnn Uses nnnnn as the octal field length 
for the current job t 

RUN,MI=nnnnn Increments the job's current field length 
by nnnnn octal. Refer to example 1. 1 



RUN,I=lfn 



RUN,T,qi,q2. 
. . . , qn 



This command applies only when run- 
ning a previously compiled (object code) 
FORTRAN program in the EXECUTE 
subsystem. It allows the user to re- 
name working files specified in the 
PROGRAM statement without recompiling 
the program. The parameters q-j^ through 
qj^ are used to specify new working file 
names to be used in place of those that 
currently exist in the PROGRAM state- 
ment (the parameters are order-depen- 
dent and must correspond to those they 
replace). Refer to example 2. 



tif the user exceeds the maximum field length for which he is validated, the message 
ILLEGAL USER ACCESS is returned to the terminal. 
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Example 1: 

The following example illustrates the use of the RUN,MI=nnnnn command. 
LNH 

00100 PROGRAM M (INPUT, OUTPUT) 

00110 DIMENSION J(17000) ^ Causes program to exceed 

00120 PRINT 4 field length (included solely 

00130 4 FORMAT (CENTER TWO NUMBERS-) for purposes of illustration) 

00140 READ, A, B 

00150 C=A-B 

00160 PRINT 5 

00170 5 FORMAT (*A X B*) 

00180 PRINT, C 

00190 END 

READY. 

RUN 

72/03/01. 16.07.31. 
PROGRAM M 

AT LINE NUMBER 00190 MORE STORAGE NEEDED FOR COMPILATION 

000001 FORTRAN ERRORS IN M t 

Diagnostic indicates that job's 

CP 0. 164 SECS. current field length was in- 

sufficient. 

RUN COMPLETE. 

RUN, MI=3000 " Additional field length is 

requested. 
72/03/01. 16.08.41. 
PROGRAM M 

ENTER TWO NUMBERS 
? 16,23 
A X B 

368.00 
END. 

CP 0.396 SECS. 

RUN COMPLETE. 

Example 2: 

The following example illustrates the use of the RUN, T command. Assume a 
FORTRAN program contains the following PROGRAM statement. 

PROGRAM TEST (INPUT,OUTPUT, AAA, BBB, TAPE1=AAA, TAPE2=BBB) 

Normally, to execute a program containing this statement, the user would have to 
define working file AAA. Working file BBB would result from the execution of the 
program. However, the user could change the names of working files AAA and 
BBB without recompiling the program (if the object program exists) by using the 
RUN, T command under the EXECUTE subsystem. For example: 

RUN, T, INPUT, OUTPUT, CCC, DDD 
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RNH 



S key 



SETTL,nnnnn 



SORT 



SORT, Ifn, 
NC=n 



This is an optional form of the RUN command which 

allows the user to run the job without a header being printed. 

The commands are identical in all other respects. 

The user presses this key to terminate a job that is currently 
transmitting output to the terminal. The use of this key is 
effective only for ASCII code compatible terminals. The system 
responds: 

-TERMINATED. - 

If pressing this key accidentally disconnects the terminal from 
the system, dial the KRONOS site and enter the RECOVER 
command in response to the RECOVER/SYSTEM: or RECOVER/ 
CHARGE: request during the log-in sequence. 

To terminate a job currently transmitting output to a corres- 
pondence code terminal, press the ATTN key. The system 
responds : 

^INTERRUPTED. * 

The user must then enter the STOP command which terminates 
the job and prints the message: 

-TERMINATED. * 

Refer to Table B-1 in appendix B for complete information 
concerning the use of special function keys for both ASCII 
and correspondence code terminals. 

Sets time limit. This command allows the user to specify a 
time limit (nnnnn octal seconds) for all subsequent operations 
requiring the central processor. If nnnnn is omitted, the 
system assumes nnnnn=100B seconds which is the normal de- 
fault value at log-in time. The minimum time limit that can 
be entered is lOB seconds. The maximum time limit is de- 
pendent upon the user's validation limits (refer to Limits 
Command at the end of this section). 

This command is useful when debugging a program that is 
cycling in a loop. It prevents the user from accumulating 
a large bill for computer usage. 

Sets an internal indicator called the sort flag. Sorting of 
the primary file takes place when the next LIST, LENGTH, 
EDIT, SUBMIT, or RUN command is entered. The lines of 
the primary file are then arranged in order according to the 
first five digits of the line number, and the file is packed into 
one logical record. 

Sorts working file Ifn by arranging the statements in order 
according to the first n digits of the line number (where 
l<n<10). If the NC option is omitted, the sort is performed 
using the first five digits of the line number. File Ifn is also 
packed into one logical record when the sort is performed. 
When the sort is complete, file Ifn is positioned at end-of- 
information (EOI) unless it is the primary file which is auto- 
matically rewound. This command forces immediate sorting 
of the specified file and is commonly used to sort the primary 
file when it is too long to be sorted automatically by the 
system. Refer to description of File Sorting in section 3 for 
additonal information. 
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STATUS, 
options 



The STATUS command performs one of four functions dependmg 
upon the options selected when entering the command. The 
possible forms of the STATUS command are: 

STATUS Requests the current job status. An 

inportant feature of this command is 
that it may be entered during job ex- 
ecution. The system responds by print- 
ing: 

TERMINAL nnn, iii 

SYSTEM - (subsystem currently active) 

FILE NAME: (primary file name) 
STATUS - IDLE No job being 

processed 



EXECUTE 



WAIT 



User job being 
processed 

User job waiting 
for computer 



Where: 



STATUS, F 



STATUS, T 



nnn Termmai 


numoer 


iii Identifier 
terminal 


that describes type of 


TTY 


ASCII code terminal 


COR 


Correspondence code 
terminal 


CORA PL 


Correspondence code 
terminal with A PL 




print 


MEMAPL 


Memorex 1240 (ASCII 
code) terminal with 
A PL print 



Requests the current job status. The system 
supplies the information described in the 
preceding format plus the file information 
supplied with the LENGTH command. Note 
that this command cannot be entered when the 
job is in EXECUTE status. An example of 
the STATUS, F command follows. 

TERMINAL 14, TTY 
SYSTEM - FORTRAN 
FILE NAME: SECTEST 
STATUS - IDLE 

FILENAM TYPE STAT LENGTH UNIT 



SECTEST 
TAPE 2 
SECB 
DATA 



.PT 
.LO 
.LO 
.LO 



0051 
0051 
0051 
0051 



0.002 
0.002 
0.046 
0.002 



KPR. 
KPR. 
KPR. 
KPR, 



Requests the accumulated CPU time for this 
session. For exaniple: 

CP. 0.046 SECS. 



4-20 



60407600 B 



STOP 



SUBMIT 



TEXT 



STATUS, J= Requests the status of a remote batch job that 

jobname was initiated with the SUBMIT command. Re- 

mote entry jobs can be submitted from either 
the time-sharing terminal or from EXPORT/ 
IMPORT. The jobname parameter is the 
name assigned to the job, by the system, 
when it is submitted. The possible re- 
plies are: 

JOB NOT FOUND. 

JOB IN INPUT QUEUE. 

JOB IN OUTPUT QUEUE. 

JOB IN PUNCH QUEUE. 

JOB EXECUTING. 

The JOB NOT FOUND, message normally 
indicates that the job has been processed 
and no longer exists in the system. How- 
ever, if the jobname is entered incorrectly 
(misspelled), this message may also be 
issued. 

The JOB EXECUTING, message indicates 
that the job is either executing or has been 
rolled out for a higher priority job. 

It is only possible to obtain the status of 
jobs submitted under the current user num- 
ber. Refer to section 8 for a complete 
description of remote job entry. 

Terminates any program that is currently in execution or waiting 
for input from the terminal. The system responds: 

^TERMINATED. * 

Allows a validated user to create a batch job deck image and 
submit it to the local batch queue as a deferred batch job. 
The user cannot interact with a job submitted for processing 
using this command. Rather, the job is treated in the same 
manner as a job submitted from the card reader at the local 
computer site or from EXPORT /IMPORT. This process is 
commonly referred to as remote job entry. Refer to section 8 
for a complete description and examples of the use of this 
command. It is recommended that the user become familiar 
with all information in section 8 before attempting remote job 
entry. 

Enter text mode. This command allows keyboard entry of source 
code (program statements, data, or text) into the primary file 
without specifying line numbers. Commands entered in text 
mode are interpreted as text and are not processed by the system. 
The system responds: 

ENTER TEXT MODE. 
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To terminate text mode from an ASCII code terminal, press 
the interrupt key (generally labeled INT, INTRPT, or BREAK). 
If a correspondence code terminal is being used, press the ATTN 
key. Note that in either case, the carriage must be positioned 
at the beginning of a new line (empty input line) to be effective. 
The system responds: 

EXIT TEXT MODE. 

Since a text file does not normally contain line numbers, and 
therefore, cannot be sorted (and packed) automatically by the 
system, a PACK command should be issued after exit from 
text mode to ensure that the data is in one logical record. 

-Ifn Initiates processing of procedure file Ifn. This allows the user 

to process a procedure file and remain interactive with his job. 

A procedure file is a source file which contains control card 
images and /or KRONOS control language (KCL) statements. 
It has the same structure as the control card record in a 
normal batch job although the JOB and ACCOUNT control cards 
required in batch jobs cannot be included. 

Optional parameters may also be included in this command. The 
command format with options is: 



-Ifn, S=ccc(oldnamj^=newnam2, oldnam2=newman2j 



oldnam =newnamjj) 



Where: 



Ifn Name of the procedure file to be processed. 

KRONOS searches for Ifn according to the 
following hierarchy. 

1. Check current working files (including 
primary file). 

2. Check system-defined procedure files. 
This can be a procedure file created 
by the installation and included as 
part of the KRONOS system. 

3. Check user's permanent file catalog for 
indirect access permanent file. File 
must not have an associated password. 

If the specified file cannot be found, the 
system responds: 

Ifn NOT FOUND. 

S=ccc Specifies control statement ccc as the first 

statement in the procedure file to be executed 

oldnam= For each occurrence of oldnam in the procedure 
newnam file, substitute newnam. This allows use of the 
same procedure file to perform several tasks 
depending upon the parameters specified. 

To create a procedure file from the terminal, the user should 
enter text mode (refer to TEXT command). After leaving text 
mode, issue the PACK command to ensure that the file is 
packed into one logical record. The file can then be SAVEd for 
future reference as an indirect access permanent file. If 
changes have to be made to the procedure file, it is necessary 
to use the KRONOS Text Editor (refer to EDIT command). 

Refer to the KRONOS Reference Manual for information concerning 
the KRONOS control cards and KCL statements available. 
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LIMITS COMMAND 

Entry of the LIMITS command provides a listing of the user's validation limits. Generally, 
validation limits are the internal system controls associated with each user number 
which govern his use of certain system resources. The listing provided describes both 
the resources available to the user and the extent to which they may be used. All 
numeric values listed are decimal unless the post radix B appears, signifying an octal 
value. The following information is listed. 

Field Description 

AB Answerback identifier (1 to 10 alphanumeric characters). 

Terminals with answerback capability automatically send 
this identifier to the system during log-in. The system 
uses the information to determine if it is a legal termi- 
nal. Each user number can have up to four terminal 
answerback identifiers associated with it. 

MTt Maximum number of magnetic tapes the user is allowed 

to have assigned to his job concurrently 

RPt Maximum number of auxiliary devices the user is allowed 

to have assigned to his job concurrently 

TL Maximum amount of central processor time in seconds 

allowed for the user's job (refer to SETTL command) 

PRt Maximum central processor priority allowed for the 

user's job 

CMt Maximum number of central memory words that the 

user is allowed to request. This is the job's maximum 
field length. 

NFt t Maximum number of files that the user is allowed to 

have associated with his job concurrently 

MSt t Maximum number of mass storage tracks the user is 

allowed to use 

PNt t Project number to which the user is assigned (not the 

project number associated with the charge number entered 
at log-in with the CHARGE command) 

DBt t Maximum number of deferred batch jobs that the user can 

have in the system concurrently (refer to description of 
SUBMIT command in section 8). 



tFor further information about this field, refer to the KRONOS Reference Manual. 
ttNot currently used by the system but provided for future expansion 
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The following three specifications control permanent file access for the individual user 
(ordinarily this is specified by origin type). 

Identifier Description 

FC = n File count indicating the maximum number of 

indirect access permanent files allowed the user, 
n may assume values in the ranges shown. The 
user is validated for the corresponding upper 
limit. 1 

n_ Upper Limit Allowed (Octal) 

Use job origin control 

I to 10 10 

II to 20 20 
21 to 30 30 
31 to 40 40 
41 to 50 50 
51 to 100 100 

101 and Not checked 

above 

If FC is not specified, n=0 will be assumed. 

CS = n Cumulative size of all indirect access files for 

this user. n may assume any value. The user 
is validated for the corresponding upper limit, f 

n_ Upper Limit Allowed (Octal Count of PRUs) 

Use job origin control 

1 to 1000 1000 

1001 to 2000 2000 

2001 to 5000 5000 

5001 to 10000 10000 

10001 to 50000 50000 

50001 to 100000 100000 

100001 and above Not checked 

If CS is not specified, n=0 is assumed. 

FS = n Maximum file size allowed for an individual in- 

direct access permanent file, n may assume the 
values listed. The user is validated for the 
corresponding upper limit, -f- 

ri_ Upper Limit Allowed (Octal Count of PRUs) 

Use job origin control. No 

controls are enacted 

I to 10 10 

II to 20 20 
21 to 30 30 
31 to 40 40 
41 to 50 50 
51 to 60 60 

61 and above Not checked 

If FS is not specified, n=0 will be assumed. 
I If the value listed for this field is SYSTEM, the actual value used is a system option. 
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Field Description 



PA Specifies that ODD or EVEN parity is associated with 

the terminal (refer to PARITY command under Terminal 
Control Commands in this section). 

ROt Number of rubout characters required for carriage 

return delay (refer to ROUT command under Terminal 
Control Commands in this section). 

PX Specifies full- or half-duplex transmission mode is 

associated with terminal (refer to FULL and HALF 
commands under Terminal Control Commands in this 
section). 

TT Specifies type of terminal; value listed may be: 

TTY ASCII code terminal with standard print 

MEMAPL Memorex 1240 terminal (ASCII code 

with A PL print) 

COR Correspondence code terminal with 

standard print 

CORA PL Correspondence code terminal with 

A PL print 

Refer to TERM command under Terminal Control Commands 
in this section. 

AW Access word; the octal value listed corresponds to the 

following access options (bit is option 1, bit 1 is option 2, 
etc. ). 

Option Signifies 

1 User can change his password (refer to 
PASSWOR command). 

2 User can use privileged time-sharing 
commands (refer to appendix E in the 
KRONOS Operator's Guide). 

3 User is allowed to create direct access 
permanent files. 
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Option Signifies 

4 User is allowed to create in direct access 
permanent files. 

5 User can have system origin status from 
any job origin if the system console is in 
DEBUG mode (refer to KRONOS Reference 
Manual). 

6 User can access common files (refer 
to KRONOS Reference Manual). 

7 User can assign nonallocatable devices 
(refer to KRONOS Reference Manual). 

8 User is allowed to access system with- 
out supplying his assigned charge and 
project numbers. 

9 User can create and/or replace files on 
auxiliary devices. 

10 User can access special transaction 
functions (refer to KRONOS Transac- 
tion Subsystem Reference Manual). 

For example, if the access word listed were 

AW = 00000000000000000215 

the user would be validated for options 1, 3, 4, and 8. 

If any parameters are included with the LIMITS command, the system responds: 
ERROR IN LIMITS ARGUMENTS. 

The following is an example output listing produced by LIMITS. 

LIMITS. 73/04/10. 13.58.35. PAGF 1 

USER123 73/02/16. 73/02/16. 



t 
* 
t 

- 1 



AB 

AB 

AB 

AB 

MT = 0, 

RP = 0, 

TL = 7777B, 

PR = 12B, 

CM = 1000B, 

NF = 20, 

MS = 100, 

PN =, 

DB = 1 , 

FC = SYSTEM, 

CS = SYSTEM, 

FS = SYSTEM, 

PA = EVEN , 

RO = SYSTEM. 
PX = HALF 



TT 
AW 



HALr , 

TTY , 

0000000000000000021 
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PERMANENT FILE COMMANDS 



All time-sharing users may access permanent files after the log-in procedure is com- 
plete. Validated users may also create permanent files (refer to LIMITS Command at 
the end of section 4 for information concerning user validation limits). 

The user number supplied during log-in represents a specific catalog in the permanent 
file system. The catalog contains a list of files saved under that user number as 
well as pertinent information about each file. All permanent file requests are made 
to this catalog unless an alternate user number or an auxiliary device is specified in 
the file request, t If an alternate user number is specified, the request is made to 
that user's catalog. If a validated user specifies that the file resides on an auxiliary 
device, the request is made to a separate catalog on that device. A separate catalog 
exists on the auxiliary device for each user with files on that device. 

User numbers that contain asterisks (*) represent users with automatic read-only per- 
mission to files in catalogs of other users. The user number must match the alter- 
nate user number in all characters that are not asterisks. For example, a user with 
the user number *AB*DE* can access all files in the catalogs of the following users. 

UABCDEF 
UABDDEE 
MABCDEl 
MAB1DE3 

All permanent files are classified according to the manner in which they are accessed. 
There are indirect access and direct access permanent files. The mode of access is 
determined by the command used to create the file. Indirect access permanent files 
are created with the SAVE command while the DEFINE command must be used to 
create a direct access permanent file. The command used to create a permanent file 
also determines the command that must be used to access the file. The user must 
enter the OLD, LIBRARY, or GET command in requests for indirect access files. 
The ATTACH command must be entered to request use of a direct access file. The 
following are characteristics of each type of file. 

• Indirect access 

An indirect access file is, as the name implies, a permanent file that cannot be 
accessed directly by the user. Instead, when access is requested through entry 
of the OLD, LIBRARY, or GET command, a copy of the permanent file is created. 
The copy, considered a working file, is referenced instead of the permanent file 
in all subsequent I/O operations. This feature offers protection from en- 
dangering the integrity of the permanent file. Several copies of an indirect 
access file may exist in the system at the same time. Note that if the work- 
ing file is altered, the user must enter the REPLACE command in order to 
update the permanent file. If the user is not allowed to update the permanent 
file, he can create a new indirect access file (to reflect his modifications) by 
entering* the SAVE command and specifying a new file name. 



tAn auxiliary device is a mass storage permanent file device used to supplement the 
normal permanent file devices associated with the system (family devices). 
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Indirect access permanent files are allocated in blocks of 64 central memory 
words (one physical record unit). "When compared to the size of blocks allo- 
cated for direct access files (refer to appendix D), this block size is relatively 
smalle Thus, permanent files that are small in size are typically indirect 
access files. This is done to avoid allocation of more mass storage area than 
is actually required for the file. 

• Direct access 

A direct access file is a permanent file which, upon request, becomes linked 
directly to the user's job. Unlike requests for indirect access files, a copy 
of the permanent file is not created for user access. Use of a direct access 
file is requested by entering the ATTACH command, and all subsequent I/O 
operations are performed on the permanent file itself. Note that although a 
copy of the permanent file is not created, a working file name may be speci- 
fied in the request for a direct access file. This allows the user to reference 
the file by a name other than its permanent file name. Because data is 
written directly on the permanent file rather than on a working copy, care 
must be taken when modifying a direct access file. 

Direct access files have a write interlock feature. This means that if one 
user has attached the file in write mode, it cannot be attached by another 
user. Likewise, if a user wishes to attach the file in write mode, he must 
wait until all users currently accessing the file in alternate modes have re- 
leased it. 

Direct access permanent files are allocated in large blocks (refer to appen- 
dix D) and are generally used as large data base files. When a user creates 
a direct access file, it is placed on the device with the most space available, 
unless a specific device type is specified in the request. If more than one 
device of the type specified exists, the file is placed on the device with the 
most space available. 

In summary, the file access mode depends upon the command that was used to create 
the file. Direct access files are created with the DEFINE command. Indirect access 
files are created with the SAVE command. A permanent file cannot be requested as a 
direct access file one time using the ATTACH command, and as an indirect access 
file later using the OLD, LIBRARY, or GET command. The command that must be 
used to access the file depends upon the command that was originally used to create 
the permanent file. 

PERMANENT FILE COMMAND FORMAT 

The following describes the general format of a permanent file request. If special 
options are desired, they must follow the specified file name. The options must follow 
the / symbol, are order- independent, and are indicated by the specified keyword (kw). 

pf c md, If n=pfn/kw.= option. , . . . , kw= option 

pfcmd Permanent file command name 

Ifn Working file name used while accessing permanent file pfn. 

Allows user to reference a permanent file by a name other 
than its permanent file name. 

pfn Name under which the file is cataloged in the permanent file 

directory. If the pfn parameter is omitted, Ifn is assumed to be 
the permanent file name. 
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UN= 



The following are the keywords and corresponding option parameters which may be included. 

^^y^^^ Option Description 

usernum Alternate user number. This parameter is neces- 

sary only if the permanent file involved resides in 
another user's catalog. To access a file in 
another user's catalog, the requesting user must 
be granted explicit permission (refer to PERMIT 
command), must have automatic read-only per- 
mission (user number contains asterisks for all 
characters that do not match in the alternate 
user number), or the file must be a semiprivate 
or public file. 



PW= 



CT = 



passwrd 



P or PRIVATE 



S or SPRIV 



M= 



PU or PUBLIC t 



m 

W or WRITE 

M or MODIFY 



A or APPEND 



R or READ 



The user has the option of specifying a one-to- 
seven character password for a file. This pass- 
word must be specified whenever alternate users 
access the file. 

Pernianent file category. The file category de- 
termines which users may access a file. There 
are three categories of permanent files. 

Files available for access only by the origina- 
ting user or by those explicitly granted permis- 
sion (refer to PERMIT command). 

Files available for access by all users knowing 
the file name, password, and user number. 
Accesses by alternate users for files of this 
category are recorded for the originator of the 
file. This includes the user number of the al- 
ternate user, the number of accesses made, 
and the date and time of the last access (refer 
to CATLIST command). 

Files available for access by all users knowing 
the file name, password, and user number. 
Only the total number of accesses to files of 
this category are recorded for the originator of 
the file. 

File or user permission mode 

Allows the user to write, modify, append, read, 
execute, or purge the file (modify permission 
applies only to direct access files) 

Allows user to modify information within a 
direct access file and/or append information at 
the end of the file. The user may also read or 
execute the file. This mode applies only to 
direct access files. 

Allows user to append information at the end 
(EOI) of the file 

Allows user to read and /or execute the file 



TThe parameter name L or LIBRARY which existed in previous versions of KRONOS 
i^T^fjn J I ""PT^"".^ compatibility. The parameter name was changed to PU or 

PUBLIC to avoid confusion with the permanent file command LIBRARY. 
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Keyword Option Description 

RM or READMD Allows user to read a direct access file with 

the implication that another user may currently 
be accessing the file in MODIFY mode. The 
file may also be executed in this mode. This 
mode applies only to direct access files. 

RA or READAP Allows user to read a direct access file with 

the implication that another user may currently 
be accessing the file in APPEND mode. The 
file may also be executed in this mode. This 
mode applies only to direct access files. 

E or EXECUTE Allows the user to execute the file 

N or NULL None; removes previously granted permission 

^3, r Specifies the type of device on which the per- 

manent file resides or is to reside; r can be 
any of the following. 

r Device 

DA 6603 disk system 

DB 6638 disk system 

DC 863 drum storage 

DDn 854 disk storage drive 

DE Extended core storage 

DF 814 disk file 

DH 821 disk file 

Din 844 disk storage subsystem 

DP Distributive data path 

]VDn 841 multiple disk drive 

n = Number of units (1< n < 8) 
The R keyword can be used in two ways. 

1. It can be specified on the DEFINE com- 
mand to indicate the type of family device 
on which the direct access file is to re- 
side. The user should consult the service 
vendor to determine which devices are 
available. Appendix D contains a list of 
the block sizes allocated for each device 
type. If the file already exists on another 
device, R is ignored. If an illegal device 
is specified, the system responds 

DIRECT ACCESS DEVICE ERROR. 

If the number of units specified does not 
agree with the actual number for device 
types DD, DI, and MD, the system issues 
the message 

ILLEGAL DEVICE REQUEST. 
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Keyword 



Option 



S = 



space 



PN = 



packname 



Description 

2. It can be used in conjunction with the PN 
and NA keywords on any permanent file 
command (including DEFINE) to identify 
an auxiliary device on which the file 
resides or is to reside. If PN and NA 
are specified but R is not, the system 
default device type is assumed. If the 
device type of the auxiliary device PN 
conflicts with the device specified by the 
R parameter, the system issues the 
message 

ILLEGAL DEVICE REQUEST. 

For example: if auxiliary device PN has 
device type DI and the device type speci- 
fied by R is MD, a conflict exists and the 
error message is issued. 

Specifies the amount of space in decimal PRUs 
desired when creating a new direct access per- 
manent file (refer to DEFINE command). There 
are 640 decimal 6-bit characters in a PRU. 
KRONOS then creates the file on a device with the 
specified amount of space available. Unused space 
is not guaranteed to be available if the user at- 
tempts to expand the file at a later date. If no de- 
vice currently has the specified amount of space 
available, the system responds 

REQUESTED SPACE UNAVAILABLE. 

If S is used in conjunction with the R keyword, only 
devices of the type specified are checked for ade- 
quate space. 

A one-to- seven character packname used in con- | 
junction with the R keyword to identify an auxiliary 
device to be accessed in the permanent file request. 
This parameter is specified only when the file to be 
accessed resides on an auxiliary device. If the 
device is currently not available and the NA key- 
word is not specified in the request, the system 
responds 

DEVICE UNAVAILABLE. 

An auxiliary device is not necessarily a disk pack 
that can be physically removed as the parameter 
name implies. Rather, an auxiliary device can 
be any mass storage device supported by KRONOS 
and defined as such by the service vendor. Aux- 
iliary devices are used to supplement the normal 
mass storage permanent file device associated 
with the system (family devices). If two or more 
auxiliary devices are to be In use concurrently, 
the user must enter the BATCH subsystem and 
issue the RESOURC control card image (refer to the 
KRONOS Reference Manual for information con- 
cerning the RESOURC control card). Note that the 
user must be validated to create or replace files on 
an auxiliary device, t 



t Refer to LIMITS Command at the end of section 4 for information concerning validation 



limits. 
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Keyword 

NA 



Option 



Description 

The NA keyword specifies that if a requested re- 
source is not available, the command will not be 
terminated and KRONOS will automatically suspend 
the user's job until the resource becomes available. 
NA can be used in two ways. 

1. It can be specified on the ATTACH com- 
mand to indicate that the user wishes to 
wait for the direct access file to become 
available. If the file is currently being 
accessed in a mode that conflicts with 

that specified in the command (interlocked), 
the user's job is suspended and subsequent 
terminal entry is not accepted. To ter- 
minate the request, enter the STOP com- 
mand, 

2. It can be used in conjunction with the PN 
and R keywords on any permanent file re- 
quest (including ATTACH) for a file that 
resides on an auxiliary device. If the de- 
vice is not currently available, the NA 
keyword directs the system to make the 
desired auxiliary device available. Note 
that the system will not make the device 
available unless the user is validated to 
have at least one auxiliary device assigned 
to his job, t 



PERMANENT FILE PROCESSING COMMANDS 

The following list of permanent file commands is available to the user, 
specified have been described on the preceding pages. 



The parameters 



APPEND, pfn, Ifn^, . . . , Un^l 
UN=usernum, PW=passwrd, PN= 
packname,R=r,NA 



ATTACH, lfn=pfn/UN=usernum, 
PW=passwrd, M=m, PN=packname, 
R=r,NA 



Appends working files lfn.,...,lfn at the end of 
the specified indirect access permanent file pfn. 
The logical structure of the files is retained, 
that is, EORs and EOFs are appended as well as 
data. Each working file is appended in the order 
specified in the command. This command can 
only be used for indirect access permanent files. 

Establishes a link to permanent file pfn for 
direct access usage. If pfn is omitted, the 
system assumes lfn=pfn. 



t Refer to LIMITS Command at the end of section 4 for information concerning validation 
limits. 
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CHANGE, nfn=ofn/PW=passwrd, 
CT=n, M=m, PN=packname, R=r, 

NA 



Note that a working file is not created since 
user access is made directly to the permanent 
file. Thus, the Ifn parameter is used when it 
is desirable to reference the attached file by 
a name other than its permanent file name (pfn). 
If Ifn specifies the name of a current working 
file, the contents of that file is lost when the 
permanent file is attached. In addition, Ifn 
cannot specify the primary file name, A direct 
access file cannot become the primary file. 

If the M keyword (permission mode) is omitted, 
the system assumes read permission for the 
attached file. The M keyword must be specified 
by all users, including the originator, if the file 
is to be modified or new information is to be 
added to the file. 

If the NA keyword is not specified and another 
user is currently accessing the file in a mode 
that conflicts with that specified in the command 
(M keyword), the system responds 

Ifn BUSY, 

If a direct access permanent file has been 
attached in the WRITE mode, it should be re- 
leased after use in order to be attached by other 
users, t In general, it is best to access the 
file in a mode that allows other users to access 
the file at the same time, 

A direct access permanent file can be released 
with any of the following commands (refer to 
section 4 for a description of these commands), 

• OLD, NEW, or LIBRARY (all working 
files also released) 

• GOODBYE, BYE, HELLO, or LOGIN 
(all working files also released) 

• CLEAR (all working files also released) 

• RETURN, Ifn (file specified is released) 

A direct access file will also be released if the 
Ifn parameter on subsequent GET or ATTACH 
commands specifies the name of the attached 
fUe, 

Allows the originator of a direct or indirect 
access permanent file to alter any of several 
parameters without having to attach and rede- 
fine the file or retrieve and save it. Note that 
this command is valid only for the originator 
of the file (UN keyword is illegal). 



tWhen a direct access permanent file is attached in the WRITE mode, the last 
modification date is incremented even if the file is not altered. 
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DEFINE, lfn=pfn/PW=passwrd, 
CT=n, M=m, R=r, S=space, PN = 
packname, NA 



The nfn parameter specifies the new permanent 
file name to be assigned; ofn is the current file 
name. If no name change is desired, only ofn 
is specified. To clear the password currently 
assigned to a file, set the new password equal 
to zero (PW=0). The CT, M, and PW keywords 
should be specified only if a change in the value 
associated with that keyword is desired. The 
PN and R keywords cannot be used to specify a 
new auxiliary device. They are used only to 
specify the device on which ofn resides. 

If the specified permanent file, ofn, is not in 
the user's catalog, the system responds 

ofn NOT FOUND. 

If a new permanent file name, specified by nfn, 
already exists in the user's catalog, the system 
responds 

nfn ALREADY PERMANENT. 

The CHANGE command also updates the last 
modification date and last access date for the 
file. 

Allows a validated user to create a direct access 
permanent file (pfn) and attach it in WRITE mode. 
If pfn is omitted, the system assumes lfn=pfn. 

If pfn is specified, the Ifn parameter can be used 
in two ways. 

• To reference the direct access file by a 
name other than its permanent file name 
(pfn). In this case, the direct access 
file created contains no information in- 
itially. Data is placed on the file in 
succeeding write operations. 

• To define a current working file as a 
direct access permanent file. It is im- 
portant to note that the working file 
specified must reside on a mass storage 
device that also supports the residence 
of direct access permanent files. If the 
file specified by Ifn does not reside on 
such a device, the system responds 

DIRECT ACCESS DEVICE ERROR. 

NOTE 

Since time-sharing users are 
generally unaware of the device 
that contains their working files, 
this use of the Ifn parameter is 
not recommended. 
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If the optional keywords are omitted, the sys- 
tem assumes the following values. 

PW None 

CT PRIVATE 

M WRITE 

R ) File is placed on device 

S i with most space available 

PN None 

NA Not applicable unless PN specified 

If the user releases the file and then wishes to 
access it at some time in the future, the 
ATTACH command must be entered (refer to the 
ATTACH command). 

For information regarding creation of indirect 
access permanent files, refer to the SAVE 
command later in this section. 

GET,lfn=pfn/UN=usernum, Retrieves a copy of the specified indirect access 

PW=passwrd, PN=packname, permanent file (pfn) for use as a working file. 

This command can only be used for indirect 
R-r, NA access permanent files. If pfn is omitted, the 

system assumes lfn=pfn. 

If the user wishes to reference the working file 
by a name other than its permanent file name 
(pfn), the Ifn parameter is specified. However, 
if Ifn specifies the name of a current working 
file, the contents of that file will be replaced 
by the copy of pfn. The current primary file 
and subsystem in use remain the same unless 
the file name specified for Ifn is that of the 
current primary file. In this case, the contents 
of the primary file is replaced by the copy of 
pfn which becomes the new primary file. 
Furthermore, if pfn has a subsystem flag asso- 
ciated with it (refer to SAVE command), that 
subsystem is selected automatically. For ex- 
ample, if file A is the current primary file and 
the user enters 

GET,A=B 

the copy of permanent file B will become the 
new primary file. If a subsystem other than 
the one currently active is associated with file 
B, it is also selected. 

If the request is for a file in another user's 
catalog (UN keyword specified), the permission 
mode (READ, WRITE, EXECUTE, etc.) is that 
which the user has been permitted for private 
files or that specified in the catalog for semi- 
private and public files. 
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LIBRARY, lfn=pfn/PW= 
passwrd, PN=packnaine 



OLD, lfn=pfn/UN=usernum, 
PW=passwrd, PN=packname 



PACKNAM, PN=packname 
or 

PACKNAM, packname 



Retrieves a copy of the specified permanent file 
from the catalog of special user number 
LIBRARY. This command can only be used for 
indirect access permanent files. 

The permission mode is that which has been 
granted for private files or specified in the 
catalog for semiprivate and public files. The 
copy of the permanent file retrieved becomes 
the new primary file and all other working files 
are released unless the next command entered 
is NODROP. 

The ATTACH, GET, or OLD command can also 
be used to access permanent files in the catalog 
of user number LIBRARY. For additional in- 
formation, refer to LIBRARY Command at the 
end of this section. 

Retrieves a copy of the specified permanent file 
(indirect access only) for use as the primary 
file. If a specific subsystem is associated with 
the file, it is selected automatically. This 
occurs only if the file was originally the prim- 
ary file and was saved while a subsystem other 
than NULL was active. Refer to the descrip- 
tion of the SAVE command in this section for 
additional information. All working files are 
released unless the next command entered is 
NODROP. 

Enables validated users to direct subsequent 

•^,^i^-»>^ .-.»-. ^■.-.+ -PAT a. v-onnoio + o +rv -Una oiTVil 1 aT»T?' rl(=>Tnr>l=> 

|j<^X JLXXCXXX«^J.i». J.J_I.V- J. V-^^VAX^^-. «w -v^ v^^V- ^>«.** — ^ J . 

specified by the packname parameter. This i 

command allows the user to omit the PN key- | 
word in requests for files that reside on that 
auxiliary device. However, if permanent files 
on another auxiliary device are to be accessed, 
the PN keyword can be included in the request 
or a new PACKNAM command can be entered. 

The user cannot access permanent files residing 
on the normal system devices (family devices) 
while the PACKNAM command is in effect. To 
access these files again, he must enter the 
PACKNAM command and set the packname para- 
meter to zero, as follows: 

PACKNAM, PN=0 or PACKNAM 

An auxiliary device is not necessarily a disk 
pack that can be physically removed as the 
command name implies. Rather, an auxiliary 
device can be any mass storage device supported 
by KRONOS and defined as such by the service 
vendor. Auxiliary devices are used to supple- 
ment the normal mass storage permanent file 
devices associated with the system (family de- 
vices). 
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Examples : 

OLD, FILE A- 



PACKNAM, *- 
PN=ABC 



Request to normal family- 
device for file FILEA 

Permanent file requests 
that follow are made to 
auxiliary device ABC, 
unless PN option is speci- 
fied in the request or a 
new PACICNAM command 
is entered 



GET, DATA *- 



Request to auxiliary device 
ABC for file DATA 



PACKNAM, *- 
PN=XYZ 



Permanent file requests 
that follow are made to 
auxiliary device XYZ 



GET, TAPE 1 *- 
GET, TAPE 2 



Request to auxiliary device 
XYZ for files TAPEl and 
TAPE 2 



PACKNAM, " Clear PACKNAM command. 

PN=0 Permanent file requests 

that follow are made to the 
normal family devices 



PERMIT ,pfn, usernum- =m. , 
usernum2=m2, . . ..usernum =mj^/ 
PN=packname, R=r, NA 

PURGE, pfn/UN=usernum, 
P'W=passwrd, PN=packname, 

R=r,NA 



REPLACE, lfn=pfn/UN=usernum, 
PW=passwrd, PN=packname, 
R=r,NA 



Grants user user num.. permission to access private 
file pfn. If the permission mode, m., is omitted, 
the system assumes read permission. 



Removes the specified permanent file from per- 
manent file storage. If the permanent file does 
not exist, the system responds 

pfn NOT FOUND. 

WRITE permission is required to purge a per- 
manent file in an alternate user's catalog (UN 
keyword specified). The PW keyword must also 
be specified if the file has a password. It is 
important to note that direct access files are not 
actually purged until the last user accessing the 
file has released it. However, subsequent at- 
tempts to access the file will be rejected. 

Allows validated users to replace the contents of 
a permanent file (pfn) with the contents of a 
working file (Ifn). If the file name specified for 
pfn does not exist, a new permanent file is 
created. This command can only be used for 
indirect access permanent files. Note that the 
REPLACE command does not affect the subsystem 
associated with the permanent file (if any). 



I 
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SAVE,lfn=pfn/PW=passwrd, 
CT=n, M=in, PN=packnaine, R=r, NA 



Creates an indirect access permanent file. This 
command allows a validated user to retain a 
copy of the specified working file in the perman- 
ent file system. If the optional keywords are 
omitted, the system assumes the following 
values. 



PW 




None 


CT 




PRIVATE 


M 




WRITE 


PN 




None 


R 


1 
f 


Not applicable unless 


NA 


PN is specified 



Unless the NULL subsystem is active when the 
primary file is saved, an internal indicator called 
the subsystem flag is set to indicate which sub- 
system is being used. That subsystem becomes 
associated with the permanent file and is selected 
automatically each time the file is retrieved in 
subsequent requests using the OLD command. 
To save the primary file without a subsystem 
association, the user must enter the NULL sub- 
system before issuing the SAVE command. Note 
that the subsystem flag is set only when saving 
the primary file. There is no subsystem asso- 
ciation when working files other than the primary 
file are saved. 



CATLIST COMMAND 

The user may wish to obtain specific information about his permanent files. This can 
be done with the CATLIST command. In addition, this command may be entered if the 
user wishes to obtain specific information about permanent files that he can access in 
catalogs of alternate users. The following is the format of the CATLIST command; the 
optional keywords (and corresponding parameters) to be included must follow the / sym- 
bol and are order-independent, 

CATLIST /LO=options, FN =pfn, UN =usernum,L=lfn,PN=packname,R=r,NA 



Keyword 



LO = 



Option 



Description 

Selects a listing of pertinent information about 
each file in the user's catalog (refer to example 1). 
If an alternate user number is specified (UN 
keyword), the user obtains a listing of all files 
that he can access in the alternate user's cata- 
log. Note that the password for files in an al- 
ternate user's catalog is not included in the 
listing. The password to files in an alternate 
user's catalog must be obtained directly from 
that user (refer to example 2). 
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Keyword 



Option 



Description 



FP 




(zero) 



FN = 



pfn 



UN^ 



usernum 



Selects a listing of permission information re- 
corded for each alternate user that has accessed 
a specified file in the user's catalog (refer to 
example 3). This option requires that a file 
name be specified (FN keyword). If an alternate 
user number is also specified (UN keyword), 
only the permission information recorded for 
that user of the specified file is listed. 

The user numbers listed include: 

• Those that have been granted explicit 
permission to the file (private file only). 

• Those that have accessed the file be- 
cause of implicit permission (semi- 
private files only). Permission informa- 
tion for alternate users that have ac- 
cessed public files is not recorded. 

Selects a short list that indicates only the names 
of the files in the user's catalog (refer to ex- 
ample 4). If an alternate user number is speci- 
fied (UN keyword), the user obtains only the 
names of the files that he can access in the al- 
ternate user's catalog. If no LO keyword is 
specified, the system assumes this value. 

Selects a short list that indicates only the user 
numbers of alternate users who have accessed 
the specified private or semiprivate file (refer 
to example 5). This option requires that a file 
name be specified (FN keyword). 

Permanent file name. This option specifies that 
catalog information is desired only for this per- 
manent file. This parameter is required when 
listing permit information (LO=FP, LO=P). If 
the short list options are selected (LO=0, LO = P), 
the message 

pfn FOUND. 

is returned if the file (or user number) is lo- 
cated. The message 

pfn NOT FOUND. 

is returned if specified file (or user number) is 
not located. 

User number. This parameter has two pur- 
poses. 

For LO=F and LO^^O. Indicates the alter- 
nate catalog for which the user desires 
catalog information (refer to example 2). 

For LO=FP and LO=P. Indicates the per- 
mission information recorded for the speci- 
fied alternate user. 
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Keyword 



L = 



Option 



Ifn 



R = 



Description 

Output file name. This is the name of a working 
file to which the CATLIST inform.ation is written. 
If this parameter is omitted, the system assumes 
L=OUTPUT and the data is returned to the ter- 
minal. If Ifn is a current working file, the CAT- 
LIST information is written at the current posi- 
tion in the file. For example, if Ifn is posi- 
tioned at the beginning- of- information (BOI), the 
contents of that file is replaced with the CATLIST 
information. If Ifn is positioned at end- of- infor- 
mation (EOI), the CATLIST information is ap- 
pended to the file as a new logical record. 

This keyword is used in conjunction with the PN 
and NA keywords to specify the type of auxiliary 
device that contains the desired catalog information. 
If PN and NA are specified but R is not, the system 
default device type is assumed. If the device type 
of the auxiliary device PN conflicts with the device 
specified by the R parameter, the system issues 
the message 

ILLEGAL DEVICE REQUEST. 

For example: if auxiliary device PN has device 
type DI and the device type specified by R is MD, 
a conflict exists and the error message is issued. 

The device types are: 

r Device 

DA 6603 disk system 

DB 6638 disk system 

DC 863 drum storage 

DDn 854 disk storage drive 

DE Extended core storage 

DF 814 disk file 

DH 821 disk file 

Din 844 disk storage subsystem 

DP Distributive data path 

MDn 841 multiple disk drive' 

n = number of units (1< n < 8) 

If the number of units specified does not agree with 
the actual number for device types DD,DI, and MD, 
the system issues the message 

ILLEGAL DEVICE REQUEST. 
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Keyword 

PN = 



Option 
packname 



NA 



Description 

The packname option identifies an auxiliary de- 
vice that contains catalog information for all 
users with files on that device. Unless the 
PACKNAM command is in effect, the FN key- 
word must be specified if a user wishes to obtain 
the following information from his catalog on an 
auxiliary device. 

e Pertinent information about each file 
that resides on the device (LO=F) 

9 Only the name of each file (LO=0) 

• Permission information for each alter- 
nate user that has accessed a specific 
file (LO=FP) 

« Only the user number of each alternate 
user that has accessed a specific file 
(LO=P) 

If two or more auxiliary devices are to be in 
use concurrently, the user must enter the 
BATCH subsystem and issue the RESOURC 
control card image (refer to the KRONOS Ref- 
erence Manual for information concerning the 
RESOURC control card). If an auxiliary de- 
vice is available in the system, the FN keyword 
can also be specified by alternate users to ob- 
tain a list of files and pertinent information 
about each file they can access on the device. 

This keyword is used in conjunction with the FN 
keyword in requests for catalog information on 
auxiliary devices. If the device is currently not 
available, NA directs the system to make the 
desired device available. If the NA keyword is 
omitted and the auxiliary device is not currently 
available, the system responds 

DEVICE UNAVAILABLE. 

Note that the system does not make the desired 
device available unless the user is validated to 
have at least one auxiliary device assigned to 
his job (refer to LIMITS command in section 4). 
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CATLIST EXAMPLES 

The following examples illustrate so/ne of the options available to the user when 
entering the CATLIST command (the user entering the command in the examples is 
USER123). 

Example 1. Listing of pertinent information about each file in the catalog of USER123. 
The command is entered in the form ... CATLIST /LO=F 



CATALOG OF USER123 



73/04/10. 13.41.59. 



FILE NAME ACCESS FILE-TYPE LENGTH DN CREATION LAST ACCESS LAST MOD 

PASSWORD MD/CNT PERM. SUBSYS DATE/TIME DATE/TTME DATE/TTME 

1 DIRFILE DIR. PUBLIC 25600 40 73/01/13. 73/03/23. 73/03/?3. 
CDC 13 READAP 19.02.50. 07.33.05. 07.33.05. 

2 DIRTEST DIR. PUBLIC 17 2<?0 40 73/01/13. 73/01/13. 73/01/13. 
CDC 4 MODIFY 16.59.05. 19.49.40. 1o. 5^.05. 

3 ABC IND. PRIVATE 1280 73/01/12. 73/03/23. 73/01/13. 
1234567 24 WRITE 06.42.13. 07.30.35. 21.16.52. 

4 TAPE1 IND. SEMI-PR 640 73/01/13. 73/03/23. 73/01/13. 

20 READ FORT. 19.58,53. 07.30.53, 21.17.54. 

5 PRIME IND. SEMI-PR 1 2P0 73/01/12. 73/03/23. 73/02/09. 
ABCDEFG 22 READ BASIC 05.38.37. 07.32.19. 13.55,4^. 

6 TAPE2 IND, SEMI-PR 1920 73/01/12. 73/03/23. 73/01/13. 

12 APPEND BASIC 06,27.00. 07.31.27. 21.20.03. 

7 BINTAPE IND. PUBLIC 11520 73/01/12. 73/01/13. 73/01/13. 
BINARY 8 EXEC EXEC. 06.37,03. 21.42,54, 21.42.54. 



Subsystem flag associated with file when it was 
saved. Blank entry indicates that the NULL sub- 
system was being used or the file was not the 
primary file when the SAVE command was issued. 
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Example 2. Listing of pertinent information about each file that USER 123 can access 
in the catalog of USER456. The command is entered in the form. . . 
CATLIST/LO=F,UN=USER456 



CATALOG OF USER123 



73/04/10. 13.44.53. 



ALTERNATE CATALOG USER456 
FILE NAME ACCESS FILE-TYPE LENGTH DN CREATION LAST ACCESS LAST MOD 
MD/CNT PERM. SUBSYS DATE/TIME DATE/TIME DATE/TIME 

1 SAMPLE IND. PUBLIC 640 73/01/13. 73/01/13. 7 3/01 /l 3. 

7 EXEC EXEC. 19.28.29. 20.13.30. 19.28.29. 

2 SBMTJOB IND. PUBLIC 1920 73/01/13. 73/02/09. 73/01/13. 

7 READ BASIC 19,22.44. 14.18.51. 19.24.21. 

3 EXAM IND. SEMI-PR 2560 73/01/13. 73/02/09. 73/02/09. 

14 WRITE FORT. 19.29.58. 14.12.08. 14.02.58. 

4 LOG10 DIR. SEMI-PR 25600 ♦ 73/01/13. 73/02/09. 73/01/13. 

6 MODIFY 19.14.06. 14.12.44. 20.29.14. 

5 DEMO DIR. PUBLIC 17280 * 73/01/13. 73/02/09. 73/02/09. 
4 READMD t 19.18.52. 14.02.05. 14.02.05. 



DN indicates device number for direct 
access files. -•' in this column indicates 
file resides on master device (refer to 
glossary for definition). 



Example 3. Listing of permission information recorded for each user that has accessed 
file PRIME (semiprivate file) in the catalog of USER 123. The command 
is entered in the form... C AT LIST / LO=FP, FN = PRIME 



CATALOG OF USER1 23 



73/04/10. 13.47.50. 



PILE NAME PRIME 
USER NUMBER PERM. ACCESSES DATE 



TIME 



1. 


USER456 


READMD 


1 


2. 


JIMALTE 


READMD 


2 


3. 


DICKOSW 


READMD 


1 


4. 


EARLDRE 


READMD 


3 


5. 


CRAIGGE 


READMD 


1 


6. 


SONYAAN 


READMD 


2 



1 73/01/13. 20.18.09. 

73/01/13. 20.44.27. 

73/01/13. 20.45.28, 

73/01/13. 20.48.20. 

73/01/13. 20.49.39. 

73/01/13. 20.51.37. 
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Example 4. List of current files in the catalog of USER 123. The command is entered 
in the form ... CATLrST/LO=0 (it is not necessary to specify the LO=0 
option since it is the default value). 



CATALOG OF USER1 23 73/04/10. 13.49.18. 

FILE NAME(S) 

DIRFILE DIRTEST ABC TAPE1 PRIME TAPE 2 BINT APE 

7 FILE(S) 



Example 5. List of alternate users that have accessed file DIRFILE in the catalog of 
USER123. The command is entered in the form... CATLIST/LO=P, 
FN=DIRFILE 

CATALOG OF USER1 23 73/04/10. 13.51.29. 

FILE NAME DIRFILE 
USER NUMBER(S) 

USER456 JIMALTE DICKOSW 
3 USER(S) 



ALTERNATE USER ACCESS 

The following examples illustrate the alternatives available for users to access files in 
alternate catalogs. 

PRIVATE FILE CATEGORY 

Working file ABC is retained by USER123 as a private indirect access permanent file 
using the following command. 

SAVE, ABC /PW=1234567 
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The following is the entry for file ABC in USER123's catalog. The listing is obtained 
by entering the CATLIST command in the form ... CATLIST/LO=F,FN=ABC 

CATALOG OF USER1 23 73/04/10. 13.53.02. 

FILE NAME ACCESS FILE- TYPE LENGTH DN CREATION LAST ACCESS LAST MOD 
PASSWORD MD/CNT PERM. SUBSYS DATE/TIME DATE/TIME DATE/TIME 

^ !^oo e . ^^^- P^^^^*^^ 1280 73/01/12. 73/03/23. 73/01/13. 

1234567 24 WRITE 06.42.13. 07.30.35. 21.16.52. 



User USER123 issues the following command to permit alternate user access. 
PERMIT, ABC, USER456=R, JIMALTE=W 

The following is the permission information recorded in the catalog of USER123. The list- 
ing is obtained by entering the CATLIST command in the form . . . CATLIST /LO=FP, FN =ABC 



CATALOG OF USER1 23 73/04/10. 13.54.18. 

FILE NAME ABC 
USER NUMBER PERM. ACCESSES DATE TIME 



1. USER456 READ 1 73/01/13. 21.29.29. 

2. JIMALTE WRITE 2 73/01/13. 21.32.33. 



The format of the commands required by USER456 and JIMALTE to access the file is; 
GET,ABC/UN=USER123,PW=1234567 or OLD, ABC/UN=USER123, PW=1234567 

Only the following users may access this private file. 

UQ^^ Information Necessary For Access 

USER123 File name ABC 

USER456 File name ABC 

File password 1234567 

User number USER 123 

JIMALTE File name ABC 

File password 1234567 

User number USER123 



60407600 A 



5-19 



SEMIPRIVATE FILE CATEGORY 

Working file TAPEl is retained by USER123 as a semiprivate indirect access permanent 
file using the following command. 

SAVE, TAPEl /CT=SPRIV,M=READ 

The following is the entry for file TAPEl in USER123's catalog. The listing is obtained 
by entering the CATLIST command in the form... CATLIST/LO=F,FN=TAPEl 



CATALOG OF USER1 23 



73/04/10. 13.55.19. 



FILE NAME ACCESS FILE-TYPE LENGTH DN CREATION LAST ACCESS LAST MOD 
PASSWORD MD/CNT PERM. SUBSYS DATE/TIME DATE/TIME DATE/TIME 

1 TAPEl IND. SEMI-PR 640 73/01/13. 73/03/23. 73/01/13. 

20 READ FORT. 19.58.53. 07.30.53. 21.17.54. 



The following is the permission information recorded in the catalog of USER123. The 
listing is obtained by entering the CATLIST command in the form... CAT LIST /LO=FP, 
FN=TAPE1 



CATALOG OF USER1 23 



73/04/10, 13.56.18. 



FILE NAME TAPEl 
USER NUMBER PERM, ACCESSES DATE 



TIME 



1, 


JIMALTE 


READ 


2 73/01/13. 


21.47.34. 


2. 


USER456 


READ 


3 73/01/13. 


21 .48.43. 


3. 


DICKOSW 


READ 


1 73/01/13. 


21.49.53. 


4. 


SONYAAN 


READ 


4 73/01/13. 


21.51.09. 


5. 


EARLDRE 


READ 


2 73/01/13. 


21.53.00. 


6. 


CRAIGGE 


READ 


1 73/01/13. 


21 .54.03. 



This indicates that six users have accessed file TAPEl the specified number of times. 
Whenever an alternate user accesses file TAPEl the first time, the permission infor- 
mation is recorded in the catalog of USER123. Each succeeding access increments the 
access count (ACCESSES). 
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The format of the commands required by all users, except USER123, to access the 
file is: 

GET,TAPE1/UN=USER123 or OLD, TAPE1/UN=USER123 

Users who may access this file are: 

User Information Necessary For Access 

USER123 File name TAPEl 

All others File name TAPEl 

Password None required 

User number USER 123 



PUBLIC FILE CATEGORY 

Working fUe BINTAPE is retained by USER 123 as a public indirect access permanent 
file using the following command, t 

SAVE, BINTAPE /PW=BINARy, CT=PUBLIC, M=EXECUTE 

The following is the entry for file BINTAPE in USER123's catalog. The list is obtained 
by entering the CATLIST command in the form... CATLIST/LO=F,FN=BINTAPE 



CATALOG OF USER1 23 73/04/10, 13.57.40, 

FILE NAME ACCESS FILE-TYPE LENGTH DN CREATION LAST ACCESS LAST MOD 

PASSWORD MD/CNT PERM, SUBSYS DATE/TIME DATE/TIME DATE/TIME 

1 BINTAPE IND. PUBLIC 11520 73/01/12, 73/01/13. 73/01/13. 

BINARY 8 EXEC EXEC, 06.37.03. 21.42.54, 21,42.54. 



Permission information is not recorded for accesses to a public file. Only the total 
number of accesses to files of this category are recorded for the originator of the file. 

The format of the command required by all users, except USER123, to access file 
BINTAPE is: 

GET,BINTAPE/UN-USER123,PW=BINARY 

or 
OLD , BINTA PE / UN =USER 1 2 3 , PW =BINA R Y 

Users who may access this file are: 

User Information Necessary For Access 

USER123 File name BINTAPE 

All others File name BINTAPE 

Password BINARY 
User number USER123 

tThe file category LIBRARY which existed in previous versions of KRONOS remains 
valid for upward compatibility. This category was renamed PUBLIC to avoid confusion 
with the permanent file command LIBRARY. 
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LIBRARY COMMAND 

The LIBRARY command allows access to indirect access permanent files in the catalog of 
special user number LIBRARY. Direct access files may also reside in the catalog of 
user number LIBRARY although an alternate method must be employed to access these 
files (described later in this section). The file category may be private, semiprivate, 
or public. The permission mode is that which has been granted for private files or 
specified in the catalog for semiprivate and public files. 

When the LIBRARY command is entered, a copy of the specified indirect access per- 
manent file is retrieved. This copy becomes the new primary file and all other work- 
ing files are released unless the next command entered is NODROP. For example: 

LIBRARY, ABC75/PW=13479 

In this example, a copy of the indirect access permanent file ABC75 is retrieved and 
becomes the new primary file. Note that only indirect access permanent files may be 
accessed with the LIBRARY command. The following commands may also be entered 
to access permanent files in the catalog of user number LIBRARY (differences in com- 
mand function are described). 

• ATTACH, lfn=pfn/ UN = LIBRARY, PW=passwrd, M=m 

This command must be entered in order to use any direct access permanent 
files in the catalog of user number LIBRARY. Note that a working file is 
not created since all I/O operations are performed directly on the permanent 
file itself. However, if the user wishes to reference the file by a name other 
than its permanent file name, he may assign a working file name (Ifn) in the 
command. The primary file name remains unchanged. 

• GET, lfn=pfn/UN = LIBRARY, PW=passwrd 

This command retrieves a copy of the specified indirect access permanent file 
(from catalog of LIBRARY) for use as a working file. The primary file re- 
mains unchanged unless Ifn specifies the name of the current primary file (refer 
to description of GET command for additional information). 

• OLD, lfn=pfn/UN=LIBRARY, PW=passwrd 

The function of this command is identical in all respects to that of the 
LIBRARY command. 

The only files that can be accessed from the catalog of LIBRARY are those that allow 
alternate user access. Note that all users, except user number LIBRARY, are con- 
sidered to be alternate users. The rules for alternate user access are summarized as 
follows : 

• Only those users permitted to private files may access them. 

• All users can access semiprivate and public files providing they know the file 
name, password (if one exists for the file), type of access (direct or indirect), 
and user number (LIBRARY). 

The following forms of the CAT LIST command may be entered to obtain a listing of 
files that can be accessed in the catalog of user number LIBRARY. 

CATLIST/LO=F,UN=LIBRARY (full listing) 

CATLIST/UN=LIBRARY (file names only) 



^_22 60407600 A 



TIME-SHARING JOB PROCESSING 



This section describes various conventions used in time-sharing job processing, as 
well as facets of system operation. 

INPUT/OUTPUT CONVENTIONS 

The following conventions and standards are used for I/O operations at a time-sharing 
terminal. 

• Standard input lines 

The standard input line entered from the terminal keyboard consists of com- 
mands or source code (program statements, data, or text). Each input line 
containing source code is placed in the primary file and must be numbered. 
The line numbers range from one to ten digits in length. Note that the line 
numbers in FORTRAN or BASIC programs cannot be more than five digits in 
length. Refer to the description of File Sorting in section 3 for additional 
information. 

• Text mode input 

Text mode allows keyboard entry of source code, into the primary file, with- 
out specifying line numbers. Commands entered in text mode are interpreted 
as text and are not processed by the system. For complete information con- 
cerning text mode, refer to the TEXT command described in section 4. 

• Text Editor input 

Normally, keyboard entry of source code is possible only to the primary file. 
However, the Text Editor allows the user to enter or modify source code in 
all working files (including the primary file) from the terminal keyboard. 

An important feature of the Text Editor is its ability to reference direct 
access permanent files. Since a direct access file cannot be referenced with 
the OLD command, it cannot become the primary file, and normal keyboard 
entry to the file is therefore impossible. The Text Editor is one method that 
is commonly used to accomplish keyboard entry of source code into a direct 
access file. The following example illustrates the use of the Text Editor 
to enter source code into an empty direct access permanent file from the ter- 
minal keyboard (note that a direct access file is empty when it is created). 



DEFINE, DIRFILE 

READY. 

EDIT, DIRFILE 

BEGIN TEXT EDITING 

? ADDS 

ENTER TEXT. 

? /THIS IS A TEST EXAMPLE TO ILLUSTRATE THE ABILITY TO ENTER 

? TEXT INTO A DIRECT ACCESS PERMANENT FILE DIRECTLY FROM THE 
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? TERMINAL KEYBOARD. DATA OR NUMBERED PROGRAM STATEMENTS CAN 

? ALSO BE ENTERED IN THE SAME MANNER. / 

READY. 

? END 

END TEXT EDITING 

CP 0.019SECS. 

READY. 

LNH, F=DIRFILE 

THIS IS A TEST EXAMPLE TO ILLUSTRATE THE ABILITY TO ENTER 
TEXT INTO A DIRECT ACCESS PERMANENT FILE DIRECTLY FROM THE 
TERMINAL KEYBOARD. DATA OR NUMBERED PROGRAM STATEMENTS CAN 
ALSO BE ENTERED IN THE SAME MANNER. 

CP 0. 007SECS. 

READY. 

RETURN, DIRFILE 

READY. 



For complete information concerning the use of the Text Editor, refer to the 
Text Editor Reference Manual. A list of the commands available under the 






Although data can be entered into a direct access file from the terminal 
keyboard, through use of the Text Editor, a program can also be used. Since 
direct access files are normally large in size, a program is generally used 
to manipulate or maintain data on direct access files. 

Length of input /output lines 

The input line may consist of 150 characters maximum. The output line may 
be any length in accordance with the line width of the terminal being used. 
If the user attempts to input or output more characters per line than are 
allowed, the additional characters overprint at the end of the line, unless 
the terminal being used has an automatic carriage return feature. 

Terminate the input line 

The user must terminate each line of input information by pressing the RETURN 
key. This tells the system that the current input line is complete. KRONOS 
responds by positioning the carriage to the beginning of the next line. The 
user can then enter additional input information on the new 1 ine. 

Correct the input line 

Entry errors in the input line can be corrected, before the RETURN key is 
pressed, through use of the backspace character. The backspace character, 
on ASCII code terminals, is the underline ( ) key.f On correspondence code 



tThe backspace character on Teletype model 33/35 terminals is the shift-'0 key. The 
character may be either an underline (_) or a left arrow (— ). 
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terminals, the BACK SPACE key is used. One character (including spaces) is 
deleted for each backspace character entered. If the beginning of the line 
is reached, further backspace characters are ignored. For example, if the 
input line contained . . . 

BAX_SJK IC 

it would be interpreted by KRONOS as the subsystem selection command BASIC, 

Delete the input line 

If the user discovers an error in the command or other input just typed, 
he can delete the current input line by pressing the ESC or ESCAPE key 
(ASCII code terminals) or the ATTN key (correspondence code terminals). 
This must be done before the RETURN key is pressed. KRONOS ignores the 
entire input line and responds by printing -DEL- and positioning the carriage 
to the beginning of the next line. The following example illustrates the use 
of the ESC key. 

NEW, TEST 
READY. 

10 PROGRAM T(OUTPUT) 
20 PRINT 6 

30 6 FORMAT (=^THIS IS A TEST-9 ) *DEL* ESC kev pressed 

40 6 FORMAT (*THIS IS IT=!<) 

50 END 

LNH 

10 PROGRAM T (OUT PUT) 

20 PRINT 6 

40 6 FORMAT (*THIS IS IT*) 

50 END 

READY. 

Input to executing program 

A ? output to the terminal normally indicates that the executing program has 
requested input. However, it should be noted that the program may include 
question marks in its normal output. 

Interrupt executing program 

To interrupt an executing program that is currently transmitting output to 
an ASCII code terminal, press the I keyt or the interrupt key (generally 
labeled INT, INTRPT, or BREAK on most ASCII code terminals). If a corres- 
pondence code terminal is being used, press the ATTN key. 

This process is commonly referred to as job suspension and is described in 
more detail in section 7. 

Terminate executing program 

To terminate an executing program that is currently transmitting output to 
an ASCII code terminal, press the S key. If a correspondence code terminal 
is being used, press the ATTN key. If the program is in execution, but is 
not actively transmitting output, enter the STOP command to terminate the 
program. 



tif the program in execution is not currently transmitting output to the terminal, the 
I key cannot be used to interrupt the program. However, the other keys described 
can still be used. 
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• System messages during input 

The following diagnostic messages can appear at anytime during input from 
the terminal. 

*OVL* Line overflow. This message is issued when 

more than 150 characters have been entered 
since the last carriage return (the entire line 
is lost when the 151st character is entered). 

*RE-ENTER LAST LINE* Data was lost during the last line of input. The 

user should reenter the last line. 

TERMINAL JOB PROCESSING 

This section explains the basic steps in processing a time-sharing job. These steps 
include: 

• Terminal log-in 

• Subsystem selection 

• Program entry and execution 

• Terminal log-off 

To use the KRONOS system from a time-sharing terminal, the user must: 

1. Check to ensure that the following switches on the terminal are set to the 
correct position. Note that one or more of the switches listed may not 
exist on the terminal to be used. However, if that terminal has been de- 
termined to be acceptable for KRONOS time-sharing operations, its use 
should correspond to that described in this manual. 

-r-< -II .1 . .. -I /1. _-|j|« J 1 /Tm~\T^ /TTr\-V\ ^,„i4.^t, A 1+l-.,-Mi -vt-< +V,-Je( <MiTr-!+<-.T-> /^TM Vxi 

• Jl" UlJ.-UUpXeJi/ IlclXl-U.upxCJi. \X' J-yy\ / XJ.l-y^~i./ owjlov-h. Jiij.uj.i'-'u.giJ. oiix^ ^wiov^x^ v-v^ii >~j^ 

set to either position, it is normally set to the half- duplex position. If 
set to full-duplex, user-generated information will not appear at the 
terminal. Refer to the descriptions of FULL and HALF commands in 
section 4 for additional information. 

• Even parity /odd parity switch. If an ASCII code terminal is being 
used, this switch must be set to even parity. Odd parity must be 
selected for correspondence code terminals. 

• Baud rate switch. This switch determines the speed at which the 
terminal transmits and receives information. There is only one 
correct position when the terminal is connected to KRONOS. How- 
ever, this is a system option and is dependent upon the system 
equipment being used. If the correct setting is not known, con- 
sult the service vendor. 

2. Connect to the central site using one of the procedures described in 
appendix B. 

When the connecting sequence is complete, certain terminals must be 
identified to the system before the log-in procedure can proceed. These 
terminals include: 

• All correspondence code terminals (such as IBM 2741, NOVAR 541, 
DATEL 30, etc.) 
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• Specific ASCII code terminals (such as Teletype Models 33, 35, 37, 
and 38, CDC 713, Memorex 1240, etc.) designated by the installation. 
The user can consult the service vendor to determine which ASCII 
code terminals require identification. If it is not necessary to identify 
the ASCII code terminal being used, skip to step 4. 

3. Identify the terminal to KRONOS as follows: 

• Correspondence code terminals with standard print 

Press the ATTN key 

• Correspondence code terminals with A PL print 

Type A and press the ATTN key 

• ASCII code terminals with standard print 

Type T 

• Memorex 1240 (ASCII code) terminal with A PL print 

Type M 

4. When communication with KRONOS has been established, the system responds 

yy/mm/dd. hh. mm.ss. 

KRONOS TIME SHARING SYSTEM - VER. 2. 1. 

and requests 

USER NUMBER: 

5. Submit the user number on the same line. 

usernum fclU 
The system then requests 
PASSWORD 

6. Enter the password 

passwrd fcl« 



If the password is required, it may consist of one to seven alphanumeric 
characters. To provide a greater measure of security, the password is 
typed in the area the system has blacked out. 



If no password is required, type: 



If the terminal was connected to an alternate or backup system in step 2, 
the alternate system requests: 



FAMILY: 



NOTE 



The installation must notify users if they are to 
connect to a system other than the one normally used. 
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7. Enter the family name on the same line. 



familyname (CR) 

The family name identifies the mass storage device(s) which contains the 
permanent files for a specific KRONOS system. Each system has its own 
family of permanent file devices. Thus, the family name entered .describes 
the device(s) which malcfes up the user's normal permanent file family. 

The device containing the validation file for the family must be present 
in the alternate system in order for the user to log-in. The validation 
(VALIDUX) file is used to determine if the user number and password entered 
are valid, etc. However, the user's permanent files may reside on another 
device, in the same family, that is not present in the alternate system. Any 
attempt to access permanent files on a device not present in the alternate 
system causes either of the following messages to be printed. 



DEVICE UNAVAILABLE. 



This message appears if the user's 
master device is not present in the 
alternate system. The user's 
master device contains his perma- 
nent file catalog, all indirect access 
files, and all, part, or none of his 
direct access files. 



• DIRECT ACCESS DEVICE ERROR. This message appears if the user 

attempts to reference direct access 
files on a device (other than his 
master device) not present in the 
alternate system. 

If the system to which a user normally connects at log-in is providing 
backup support for another KRONOS system, the FAMILY: request ia alao 
issued. In this event, the user need only type carriage return in response. 
The normal system family name is assumed by default. 

NOTE 

Steps 5, 6, and 7 can be combined into one step in 
order to speed log-in. This allows the user to enter 
his user number, password, and family name together 
on the same line (in response to USER NUMBER: re- 
quest). Each item entered is order-dependent and must 
be separated by commas. That is, if no password 
or family name is required and this method of log-in is 
desired, the usj^ number must be followed by a single 
comma and C^ . If the family name is required and 
the password i&not, the user number mugt be followed 
by two commas, the family name, and rc^TO . 

If the user number, password, or family name are not acceptable, the system 
responds: 

IMPROPER LOG IN, TRY AGAIN 
USER NUMBER: 
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If the user is unsuccessful at logging- in four times in succession, the system 
issues the message 

ILLEGAL TERMINAL. 

and then disconnects the terminal from the system. 

If the user number, password, and family name are acceptable, the system 
responds: 



TERMINAL: nnn, iii 
RECOVER/ CHARGE: 



or 



TERMINAL: nnn, iii 
RECOVER /SYSTEM: 



Where: 
nnn 

iii 



Terminal number that the system uses as part of the unique 
identifier for each active user. This number is required in 
certain recovery cases (refer to section 7 for a description 
of terminal recovery). 

Terminal type identifier. Can be one of the following: 

TTY ASCII code terminal with standard print 

MEMAPL Memorex 1240 terminal (ASCII code) with APL print 

CORAPL Correspondence code terminal with APL print 

COR Correspondence code terminal with standard print 

8. Perform part a or part b of this step depending upon which system response 
was issued in step 7. 



a. 



If the RECOVER/ SYSTEM: response was issued, enter the subsystem to 
be used or any valid command (refer to sections 4 and 5). 



BASIC (CR 



BATCH, nnnnn (C^ 



To use the BASIC language 

To enter control card images interactively 
from the terminal; nnnnn is the field length 
to be used 



EXECUTE 
FORTRAN 



(CR) 



To execute a previously compiled program 
To use the time- sharing FORTRAN language 

To BASIC, FORTRAN, or EXECUTE, the system responds: 
OLD, NEW, OR LIB FILE: 

To BATCH, nnnnn the system responds: 



$RFL, nnnnn. 
/ 



(nnnnn is the specified field length) 
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b. If the RECOVER/ CHARGE: response was issued, type CHARGE, followed 
by a valid charge number and project number. 

CHARGE, charge no, projectno (c^ 

The system responds: 

READY. 

The user then enters the name of the subsystem to be used or any valid 
command (refer to sections 4 and 5). 

To use the BASIC language 

To enter control card images interactively 
from the terminal; nnnnn is the field length 
to be used 

(CR) To execute a previously compiled program 

(CR) To use the time- sharing FORTRAN language 



BASIC (CR) 
BATCH, nnnnn 

EXECUTE 
FORTRAN 



To BASIC, FORTRAN, or EXECUTE, the system responds: 

OLD, NEW, OR LIB FILE: 
To BATCH, nnnnn the system responds: 



$RFL, nnnnn. 
/ 

9. Enter the appropriate file type. 
OLD (C^ 



NEW (C 
LIBRARY 



(nnnnn is the specified field length) 



For a file that was previously saved as a 
permanent file (the file cannot be a direct 
access file) 

For a new working file 

For an indirect access permanent file that 
resides in the catalog of user number 
LIBRARY 



The system responds: 

FILE NAME: 
For responses to BATCH requests, refer to section 9. 
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10. Enter the file name (one to seven characters). 
Ifn (Ci 



If an OLD or LIBRARY file is specified, but does not exist, the system 
responds: 

pfn NOT FOUND. (pfn is the name of the file requested) 

The user must then return to step 8 and attempt to enter the file type and 
file name again. 

If no errors are detected, the system responds: 

READY. 

The following example illustrates a sample log- in. 

72/10/02. 11.00.00. 

KRONOS TIltE SHARING SYSTEM - VER. 2. 1. 

USER NUMBER: USER123 

PASSWORD 



1A|B jClDlElFlGi BB The password cannot be seen and is 

TERMINAL: 40, TTY shown in this manner solely for 

RECOVER/ SYSTEM: BASIC purposes of illustration. 

old; new, or LIB FILE: OLD 
FILE NAME: DEMO 

READY. 

To hasten the preceding log- in sequence, the user may select the short form 
as follows : 

72/10/02. 11.00,00. 

KRONOS TIME SHARING SYSTEM - VER. 2. 1. 

USER NUMBER: USER123, ABCDEFG User number and password 

entered on same line 
TERMINAL: 40, TTY 
RECOVER/ SYSTEM: BASIC, OLD, DEMO -■ Subsystem, file type, and 



READY. 



file name entered on 
same line 



Note that any timie the OLD command is used in requests for indirect access 
permanent files (refer to preceding examples), the subsystem need not be 
specified unless the file requested has a NULL subsystem flag associated with 
it. If the file has a subsystem flag other than NULL associated with it (that 
is, BASIC, FORTRAN, EXECUTE, or BATCH), that subsystem is selected 
automatically. A subsystem flag becomes associated with a file when it is 
saved (refer to the SAVE command in section 5). 

In the following example, the user logs into the system and requests file DEMO 
with the OLD command. He does not specify a subsystem since he knows that 
the subsystem flag associated with the file causes BASIC to be selected auto- 
matically. 
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72/10/02. 11.00.00. 

KRONOS TIME SHARING SYSTEM - VER. 2. 1. 

USER NUMBER: USER123, ABCDEFG 

TERMINAL: 40, TTY 

RECOVER/ SYSTEM: OLD, DEMO The BASIC subsystem flag 

READY. 



associated with file DEMO causes 
BASIC to be selected automatically. 



To ensure that the BASIC subsystem has indeed been selected, the user can 
enter the STATUS command. The system responds: 

TERMINAL: 40, TTY 
SYSTEM - BASIC 
FILE NAME: DEMO 
STATUS - IDLE 

11. Perform all necessary file creation and/or file retrieval activity. If new 

BASIC or FORTRAN programs are entered, each line must be entered in the 
proper format and must begin with a one- to five- digit line number. Refer to 
the Time- Sharing FORTRAN and/or BASIC Reference Manuals for complete 
information concerning each language. 

Enter the following command to compile and/or execute a BASIC or FORTRAN 
program. 

RUN 

This command causes the FORTRAN or BASIC program to be compiled and 
executed. The RUN command is also used to execute a program under the 
EXECUTE subsystem. 

The output of a BASIC or FORTRAN program is in the form: 

yy/mm/dd. hh. mm. ss. 
PROGRAM nnnnnnn 

(data requested or gener- 
ated by the program; 
error messages if pro- 
gram errors occurred) 

CP 0. 032 SECS. t 
RUN COMPLETE. 



•f- The output of CPU time (for the preceding activity) after completion of job execution occurs 
only in the BASIC, FORTRAN, and EXECUTE subsystems. The total accumulated CPU 
time since log- in may be determined in all subsystems by entering the STATUS, T command. 
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If the user wishes merely to compile object code which can be saved and used 
at a later time, he enters the command 



RUN, B=lfn (a 

where Ifn is the name of the file on which the object code is written. 

If the user wishes to retain the compiled program for later execution under 
the EXECUTE subsystem, the SAVE command must be entered (no subsystem 
name is retained when a working file, other than the primary file, is saved). 

Refer to sections 4 and 5 in this manual for complete information concerning 
the time- sharing commands available to the user. These commands include: 

• Terminal control commands 

• Subsystem selection commands 

• Time- sharing job commands 
e Permanent file commands 

Appendix G of this manual illustrates a sample session at the terminal. 

LOG-OFF PROCEDURE 

When the user completes job processing, he logs off the system by typing: 



BYE rc 
or 
GOODBYE fC 



These commands log the user off the system, release all current working files, and 
cause the following information to be printed at the terminal. 

usernum LOG OFF. hh. mm. ss, 

usernum CP s. sss. SEC. 

Where : 

usernum User number 

hh. mm. ss. Current time in hours, minutes, and seconds 

s. sss Number of seconds of central processor time used 

The terminal is then disconnected from the system. 
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ALTERNATE LOG-OFF/LOG-IN 

When the terminal is connected, another user may wish to use the terminal. To log 
the present user off the system and reinitialize the log- in sequence, type: 



HELLO (CR) 

or 
LOGIN fCR) 



The system logs the current user off the system, issues the normal log-off messages, 
and then automatically initiates a new log- in sequence. The new user proceeds as 
described earlier in this section. 
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ADDITIONAL SYSTEM FEATURES 



This section contains a description of the program editing, job suspension, and 
recovery features provided for the KRONOS terminal user. 

PROGRAM EDITING 

To allow ease of editing the primary file when working with source programs, KRONOS 
provides a simplified editing capability that can be used under any subsystem, t This 
capability allows the user to: 

• Insert statements into a program 

• Delete statements from a program 

• Correct statements in a program 

The following example illustrates this program editing capability. The user types: 

10 LET A = l ^^ 

20 LET B = 50 ^R 

30 FOR 1=1 TO B (C^ 

40 A=A*I (CR) 

50 PRINT "FACTORIAL" ; I, A (c^ 

60 NEXT I 6r) 

70 END (CR) 
If the user wishes to insert a statement between line numbers 10 and 20, he types: 

15 LET Z=20 (cr) 
If the user wishes to delete the statement at line 20, he types: 

20 (^ 
Finally, to change the statement at line number 30, the user types: 

30 FOR 1=1 TO Z (cI 



Leading zeros are not required even if the statement being deleted or corrected con- 
tains line numbers with leading zeros. For example, a line numbered 30 would 
replace and be interchangeable with a line numbered 00030. 



TFor more detailed editing, the Text Editor should be used. Refer to the Text Editor 
(EDIT) Reference Manual for complete information concerning its use. 
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When the file is listed, it has the following form. 

10 LET A = l 

15 LET Z=20 

30 FOR 1=1 TO Z 

40 A=An 

50 PRINT "FACTORIAL" ; I, A 

60 NEXT I 

70 END 
To replace the new version of the file in the permanent file system, use: 

REPLACE 
If the user wishes to save the file under a new name, he may enter: 

REPLACE, lfn=pfn 

Ifn Primary working file name 
pfn Permanent file name 



RESEQUENCING LINE NUMBERS 

It is often convenient to resequence the line numbers of the primary file. This is 
done using the following command. 

RESEQ, nnnnn, iiii, t (S 

Where: 
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nnnnn New line number of the first statement (five digits maximum); 
if omitted, the system assumes nnnnn =00 100 

iiii Increment to be added to nnnnn; if omitted, the system assumes 

iiii=0010 

t Type of file to be resequenced 

B For files that contain BASIC source code. BASIC statements 

that contain references to line numbers are updated when 
the line numbers are resequenced. 

T For files that contain text source information. A five-digit 

line number, plus a blank, is added at the beginning of 
each line. No inspection is made for existing line numbers. 
Thus, if line numbers currently exist, they are not re- 
sequenced or deleted and two sets of line numbers result. 

other Any number at the beginning of a line is considered a line 

number and is resequenced according to the nn and ii 
parameters; line numbers are added to the beginning of 
lines where none appear. 

default The user must change to the correct subsystem before entering 

the RESEQ command. 

BASIC programs are resequenced under the BASIC subsystem; 
statements with line number references are updated. Note 
that language errors in the BASIC program may cause faulty 
resequencing. 

FORTRAN programs are resequenced under the FORTRAN 
subsystem; statement numbers and references to statement 
numbers are not changed. 
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All parameters supplied in the RESEQ command are order-dependent (must be entered 
in the order they appear in the command). Omitted parameters must be indicated by 
a comma if other parameters are to follow. For example, the command 

RESEQ, 50, , T 

adds line numbers to the primary (text) file without checking for existing line numbers. 
Thus, the first line is numbered 00050 and each succeeding number is incremented by' 
10 (default value). If the T parameter was not specified in the command, the two 
preceding commas would not have been necessary. 

If the starting line number (nn parameter) is greater than five digits in length or the 
increment value (ii parameter) causes the line numbers generated to exceed five digits 
in length, the message 

LINE NUMBER LIMIT EXCEEDED, 
is returned to the terminal. In addition, the message 

RESEQ NUMERIC PARAM ERROR, 
is returned if the user enters a nonnumeric value for either the nn or the ii parameters. 

JOB SUSPENSION 

A user may suspend his job at any time during program execution (RUN command 
issued). If an ASCII code terminal is being used, this is done by pressing the inter- 
rupt key (generally labeled INT, INTRPT, or BREAK). If the program is actively 
transmitting output to the terminal, the I key may also be used to suspend the job. 
If a correspondence code terminal is being used, only the ATTN key may be used *to 
suspend the job. The system responds: 

-INTERRUPTED* 

A job can also be suspended automatically by the system when: 

• The job has exceeded its time limit (the message TIME LIMIT is provided). 
The time limit is initially set to 100 octal seconds at log-in although the 
user may change this value through use of the SETTL command (refer to 
description in section 4). 

• A successful recovery has been performed (refer to Recovery later in this 
section). 

If the job was suspended by the user (interrupted) or by the system after a successful 
recovery, the user may perform one of the following. 



CR; Continue (transmit current output).! If the program was 

transmitting output to the terminal when it was suspended, 
the remaining output is transmitted when this response is 
made. Note that a portion of the Output may be lost. When 
output is complete, program execution continues. 



P (CR) Proceed (discard current output). If the program was 

transmitting output to the terminal when it was suspended, 
the remaining output is discarded and program execution 
continues when this response is made. 



tif the TAPE command is in effect (ta^ mode), carriage return is ignored when 
entered on an empty input line. P CR must be issued to resume execution. 
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STOP (CR 



other 



Terminate the job. 
Terminates the job. 



If the job was suspended because it exceeded its time limit (TiMii; LIMIT message 
issued), the user may respond as follows: 

• T, nnnnn (CR) Incremient central processor time limit by nnnnn (number 
^-^^ of octal seconds). When a job exceeds its time limit, 

this response is required to continue job execution. Any 
other input will terminate the job. 

The following example illustrates the use of the I key to interrupt a program (note 
that -the I key is effective only for ASCII code terminals). 

LNH 

00100 REM TEST FOR I KEY 

00110 FOR 1 = 1 to 100 

00120 PRINT I 

00130 NEXT I 

00140 INPUT A,B 

00150 PRINT A,B 

00160 END 

READY. 



RNH 
1 
2 
3 

4 
5 



'^INTERRUPTED, 



25 
26 
27 
28 
29 
30 
31 



^INTERRUPTED. 



? 2,7 
2 

CP 



The job is interrupted by the I key. 

The user continues by pressing the carriage 
return key (some output was lost). 



0. 105 



7 
SECS. 



The job is again interrupted by the I key. 

The user coirtinues execution of the job by 
entering P (CH (all output generated but 
not yet transmitted to the terminal when 
the interrupt occurred is discarded). 
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In the following example, a program exceeds its allocated time limit. The program then 
runs to completion when a new time limit is entered. 

RECOVER/SYSTEM: FORTRAN,OLD, NM 
READY. 

LNH 

00100 PROGRAM T(OUTPUT) 

00110 DO 6 1 = 1, 1000 

00120 DO 6 J = l, 1000 . 

00130 A = l 

00140 6 CONTINUE 

00150 END 

READY. 

SETTL, 10 

CP 0.001 SECS. 

READY. 

RNH 

TIME LIMIT. 
T, 1000 

END. 

CP 15.421 SECS. 

RUN COMPLETE. 

RECOVERY 

During job processing, recovery may be necessary when: 

• The terminal has been accidentally disconnected from the system. 

• A system malfunction has occurred which requires a restart. 

The user is placed in recovery state whenever he is disconnected from the system 
without logging off, providing that he is not already in recovery state. The user is 
given 10 minutes to initiate recovery. 

In order to recover, a user completes the log-in sequence to the point where the 
system requests RECOVER/SYSTEM: (or RECOVER/CHARGE:). For example: 

72/10/02. 16.07.24. 

KRONOS TIME SHARING SYSTEM - VER. 2.1. 

USER NUMBER: USER123, ABCDEFG " User number and password entered 

TERMINAL: 15, TTY-« Terminal number /type identifier 

RECOVER/SYSTEM: 

In response, the user enters: 

RECOVER, nnn (S 
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Where: 

nnn Terminal number being used when the failure occurred. This number 

was indicated when the user initially logged-in (refer to preceding 
example). If the same terminal number is indicated when the user 
logs -in to recover, this parameter is not required. 

The RECOVER command is valid only when entered in response to the RECOVER/ 
SYSTEM: or RECOVER/CHARGE: request during the log-in sequence. If the user's 
terminal number is not the same as before the failure, the previous terminal number 
must be entered with the RECOVER command (nnn parameter). This may occur when 
the failure is due to a dropped line connection. In this case, a different terminal 
numiber may be assigned at log-in because of telephone switching rotaries. If the 
RECOVER command is not entered where indicated, the user may log-off, log-in 
again, and then enter the RECOVER command correctly. 

If the system responds RECOVERY IMPOSSIBLE, one of the following conditions has 
occurred. 

• No record was found of the specified user being logged-in on the given 
terminal number within the past 10 minutes. 

• The user's system information was incorrect due to system malfunction. 

If the user receives this message, he should check the terminal number he has entered. 
If he finds he has not given the correct number, he may reenter RECOVER with the 
correct terminal number. 

If recovery is successful, the system responds: 

RECOVERED - ENTER (CR) TO CONTINUE 

T ACT' r^rMV/m/TAATT^ ^^^^ 

NEXT OPERATION - 

yyyyy 

nnnn Name of last command processed. If source code was being 

entered, the word SOURCE is output. 

yyyyy One of the following messages: 

Message Description 

IDLE. No activity. 

INPUT REQUEST. Job is awaiting input data. 

OUTPUT AVAILABLE. Output data is available. 

EXECUTING. Job is active with no output. 

REENTER COMMAND. Last command was not processed. The 

user should reenter the command. 

REENTER INPUT. The last line of input data was lost. 

SORT. The primary file is waiting to be sorted. 

If the message FILES LOST is also issued, one or more working files was lost. This 
would occur only on system malfunction. 

The user must then issue a carriage return to restart his job. If the job was previously 
transmitting output, the output data normally resumes a few lines prior to where the 
interruption in service occurred. 
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In general, recovery in the KRONOS system has been designed to provide minimum 
mconvenience to the user with a maximum of security. It should be realized, however, 
that under certain conditions recovery of user information cannot be perfect. The 
following are two examples of these circumstances. 



• 



• 



In some cases, a few lines of output may be lost when a phone line is dis- 
connected just as a job is being restarted to generate more output. This 
actually occurs before current output is exhausted. 

If a phone line is disconnected when a user is entering source code, he 
can normally expect to lose the last few lines of text he has entered. 



Whenever the user and terminal numbers of a user who must be placed in the recovery 
state match the user and terminal numbers of a user already in the recovery state, the 
user who was originally in the recovery state remains there and the other user is 
logged off. 



An example of a normal recovery is: 

72/10/02. 16.10.02 

KRONOS TIME SHARING SYSTEM - VER. 2. 1, 

USER NUMBER: USER123 

PASSWORD 



TERMINAL: 16, TTY 
RECOVER/SYSTEM: RECOVER, 12 
RECOVERED - ENTER (CR) TO CONTINUE 
LAST COMMAND - RUN 
NEXT OPERATION - 
IDLE. 



The user types fcm to continue job processing. 

The following example illustrates a sample recovery. 

72/10/02. 16.12.08. 

KRONOS TIME SHARING SYSTEM - VER. 2.1. 

USER NUMBER: USER123, ABCDEFG 

TERMINAL: 15, TTY 

RECOVER/SYSTEM: FORTRAN, OLD, AA 

READY. 

LNH 

10 PROGRAM AAdNPUT, OUTPUT) 

20 PRINT 4 

30 4 FORMAT(=f^ENTER 2 NUMBERS*) 

40 READ, A, B 

50 C=A*B 

60 PRINT 5 

70 5 FORMAT(*A X B=*) 

80 PRINT, C 

90 END 

READY. 
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RNH 

ENTER 2 NUMBERS 



The user is disconnected and logs in again. 



72/10/02. 16.13.14 

KRONOS TIME SHARING SYSTEM - VER. 2.1. 

USER NUMBER: USER123, ABCDEFG 

TERMINAL: 15, TTY 

RECOVER /SYSTEM: RECOVER 

RECOVERED - ENTER (CR ) TO CONTINUE. 

LAST COMMAND-RNH 

NEXT OPERATION - 

INPUT REQUEST. 



The user enters (CEU to continue. 



? 4,5 
A X B^ 



20.00 



END. 

CP 0.004 SECS. 

RUN COMPLETE. 



This example illustrates another recovery situation. 

STATUS 

TERMINAL: 32, TTY 
SYSTEM - BASIC 
FILE NAME: BB 
STATUS - IDLE 



LNH 



10 REM Tins IS A TEST 

20 REM PRINT B 

30 PRINT "PRINT B" 

40 LET B = l+3 

50 PRINT B 

60 END 

READY. 



The user is disconnected. 



72/10/04. 15.16.23. 

KRONOS TIME SHARING SYSTEM - VER. 

USER NUMBER: USER123, ABCDEFG 

TERMINAL: 32, TTY 

RECOVER/SYSTEM: 



2. 1. 



The user is disconnected before recovering 
This is processed as a normal log-off. 
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72/10/04. 15.17.20. 

KRONOS TIME SHARING SYSTEM - VER. 2. 1. 
USER NUMBER: USER123, ABCDEFG 
TERMINAL: 32, TTY 

RECOVER /SYSTEM: RECOVER, 32-- The user enters the RECOVER command, 

RECOVERED - ENTER (CR) TO CONTINUE. 
LAST COMMAND-LNH 
NEXT OPERATION - 
IDLE. 



The user enters {Ciy to continue. 



LNH 

10 REM THIS IS A TEST 

20 REM PRINT B 

30 PRINT "PRINT B" 

40 LET B = l+3 

50 PRINT B 

60 END 

READY. 
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REMOTE JOB ENTRY 8 



Remote job entry is a feature of KRONOS that enables a validated, time- sharing user 
to submit batch job deck images to the system for processing. The batch job image 
can be created interactively at the time- sharing terminal and then submitted to the 
local batch queue by entering the SUBMIT command. The user is no longer interactive 
with the job once it has been submitted. Instead, the job is treated in the same manner 
as a job submitted from the card reader at the local computer site or from a remote 
batch terminal (EXPORT/ IMPORT). The batch job image can consist of control card 
images, KRONOS control language (KCL) statements, program statements, and data. 
The structure of the batch job image must also be the same as its counterpart on 
cards (job deck). The user can specify how the job is to be structured through use 
of the reformatting directives described in this section. Refer to the KRONOS Refer- 
ence Manual for information concerning job structure and a description of the batch 
control cards and KCL statements available. 

The format of the SUBMIT command is: 

SUBMIT(lfn, q, NR)c 

Where: 



Ifn 



Name of file to be submitted to KRONOS for processing as a deferred 
batch job. If Ifn is omitted, the primary file name is assumed. In 
this case, the primary file is sorted before being submitted. Permanent 
files may also be submitted but first must be associated with the job via 
the OLD, GET, or ATTACH command. 

Specifies disposition of job output as follows: 

B Job output is disposed to local batch queue to be printed, punched, 

etc., at the central site. 



N 



Job output is disposed to local batch queue, but output is dropped 
at job termination (default value). 



NR 



E Job output is disposed to EXPORT/ IMPORT queue for printing at 

a remote batch terminal. 

No rewind option; inhibits rewind of file specified by reformatting directive 
cREAD (refer to Reformatting the Submit File later in this section). If 
omitted, file specified by cREAD directive is automatically rewound. 

Escape character used to identify reformatting directives in the file to 
be submitted (Ifn). If omitted, the system assumes c = /. 



60407600 B 



After the job has entered the local batch queue, the system responds: 



hh. mm. ss. jobname 
READY. 



Where: 

hh. mm. ss. Time that the job entered the batch queue 

(hours, minutes, seconds. ) 

jobname Job identification 

The job identification is entered with the STATUS, J=jobname command to obtain the 
status of a job once it has entered the system. Refer to the description of the STATUS, 
J command in section 4 for additional information. 

REFORMATTING THE SUBMIT FILE 

The submit file (Ifn in the SUBMIT command) is a file which contains the batch job 
image submitted to KRONOS for processing. The reformatting directives described m 
this section are provided to aid the user in preparing the submit file. When the 
SUBMIT command is entered, the submit file is reformatted according to the directives 
that appear in the file and is then placed in the batch input queue awaiting execution. 
Thus, several of the directives are provided to format the submit file to meet the 
structural requirements of a batch job (refer to section 3 in the KRONOS Reference 
Manual). 

Each line in the submit file preceded by an escape character is recognized by KRONOS 
as a reformatting directive. The escape character to be used must be defined in the 
bU-BMii' commana \i oy ueiauii;. jLnx-uugnuut tmo .aco^^j. i.p«.j.wLx, uxxv. x^^..^- ^, ^^^^^^^.^^ 
a directive, denotes the escape character. Reformatting directives may be interspersed 
throughout the submit file as long as transparent mode is not in effect. Transparent 
mode is selected by the cTRANS directive and requires that the user observe special 
rules when inserting subsequent directives into the file (refer to the description of 
cTRANS and cNOTRANS directives). 

It is important to note that reformatting directives will not be processed unless the 
first line of the submit file contains the cJOB directive. In addition, the first two 
card images following the cJOB directive (second and third lines of the submit file) 
must be a JOB and ACCOUNT card, respectively. All following information is deter- 
mined by the user. Thus, the first three lines of a submit file that is to be reformatted 
before processing should be: 

00100 cJOB 

00110 JOBNAME, . . .* JOB card image 

00120 ACCOUNT,...- ACCOUNT card image 
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NOTE 

The JOB and ACCOUNT cards are required in all 
batch jobs and must be present even though the 
cJOB card is omitted. 

Although text mode may be used to create a submit file, it is not necessary since each 
line niay or may not have a leading line number. The cSEQ and cNOSEQ directives 
are used to determine, during reformatting, if line numbers in the submit file will be 
retained. Therefore, it is a simple matter to include line numbers on the entire submit 
file and specify which line numbers are to be removed during reformatting. This is 
especially useful if the submit file contains a BASIC program where line numbers are 
a requirement of the language. 

The reformatting directives available are described as follows: 

cJOB Indicates that the submit file is to be reformatted and selects the following 

default reformatting directives. The default directives remain in effect 
until specified otherwise. 

cNOTRANS (disabled by c TRANS) 
cSEQ (disabled by cNOSEQ) 

cPACK (disabled by cNOPACK) 

The cJOB directive must be the first line of the submit file. If omitted, 
the file is not reformatted. 

cEOR Indicates that an end- of- record mark is to be placed at this point in the 

submit file during reformatting 

cEOF Indicates that an end-of-file mark is to be placed at this point in the 

submit file during reformatting 

cSEQ Indicates that line numbers will be removed from all subsequent lines 

during reformatting (default value) 

cNOSEQ Reverses the effect of the cSEQ directive. No attempt is made to remove 

leading line numbers from subsequent lines. 

cPACK Indicates that all succeeding internal EOR and EOF marks be removed 

during reformatting (default value). This directive applies only to internal 
EOR and EOF marks that currently exist. The cEOR and cEOF reformat- 
ting directives are not affected. 

cNOPACK Reverses the effect of the cPACK directive. Requests the system not to 

discard succeeding internal EOR and EOF marks that currently exist. 

cTRANS Indicates transparent mode. When encountering this directive during 

reformatting, KRONOS checks the next line of the submit file for an 
additional reformatting directive. If one exists, it is processed and the 
following line is checked. This continues until a line that does not 
contain a reformatting directive is encountered. Transparent mode is 
then selected and all directives that exist on subsequent lines are ignored 
until an internal EOR or EOF , is encountered (not cEOR or cEOF). The 
cPACK and cNOPACK directives, determine if the internal EOR or EOF 
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will be retained. The line following the internal EOR or EOF mark 
is then checked for a reformatting directive. If one exists, it is 
processed and the following line is checked. All directives are 
processed until a line that does not contain a reformatting directive 
is encountered. This causes transparent m.ode to be reset unless a 
cNOTRANS directive was encountered. This process continues until 
either the end of the submit file is reached or until a cNOTRANS 
directive following an internal EOR or EOF is encountered. 

The c TRANS directive is typically used in conjunction with the cREAD 
directive. This allows the user to copy the contents of an existing 
file into the submit file at the location of the cREAD directive. Be- 
cause the file is read in transparent mode, no check for reformatting 
directives is attempted until an internal EOR or EOF is encountered. 
Note that the cREAD directive must follow the c TRANS directive and 
must be located before the first succeeding line that is not a reformat- 
ting directive. If not, transparent mode is selected before the 
cREAD directive is encountered, and the cREAD will be ignored. 

The cSEQ or cNOSEQ directive in effect before transparent mode 
was selected has no effect upon the submit file or the file being read 
(cREAD) while transparent mode is in effect. Note, however, that 
the cPACK or cNOPACK directive in effect before transparent mode 
was selected remains in effect after it is selected. 

cNOTRANS Reverses the effect of the cTRANS directive and informs the system 
that the submit file is to be examined on a line-by-line basis. All 
directives encountered in the submit file while the cNOTRANS direc- 
tive is in effect are processed. This directive is initially selected 
by default and remains in effect until a c TRANS directive is en- 
countered in the submit file. 

Caution should be observed in the placement of this directive in the 
submit file. If transparent mode is selected, this directive can 
possibly be ignored unless it immediately follows either a cREAD 
directive in the submit file or an internal EOR or EOF mark. 

cREAD, Ifn Requests that the system read the entire contents of the specified file 
(Ifn) and insert that file in place of the cREAD directive in the submit 
file, during reformatting. If the file to be read is not currently 
attached to the user, KRONOS automatically attempts a GET and 
then an ATTACH on the file. If Ifn is not specified in the directive, 
TAPEl is assumed. If the file specified cannot be found, the message 

NO READ FILE - Ifn 

is issued to the job dayfile, and the job is terminated. If the read 
file is found to be busy {direct access files only), the message 

READ FILE BUSY - Ifn 

is issued to the job dayfile and the job is terminated. The file 
specified by Ifn in the cREAD directive is automatically rewound 
before the read operation unless the NR parameter is specified in 
the SUBMIT command. In this case, the cREWIND directive must 
precede the cREAD directive in the submit file if it is desired to 
rewind file Ifn before the read operation begins. KRONOS returns 
all files specified in cREAD directives before completion of the job. 
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If the cPACK directive is in effect at the time of the read, all 
internal EOR and EOF marks will be removed. If the cNOPACK di- 
rective is in effect, all internal EOR and EOF marks are read into 
the submit file in the proper position during reformatting. 

Unless transparent mode is in effect when file Ifn is read, each line 
of that file is also checked for a reformatting directive. Any direc- 
tives contained in the file, except another cREAD, are processed. 
The cREAD directive cannot be nested. In addition, any directives 
in effect before the cREAD directive is processed remain in effect 
for the file being read, unless transparent mode is selected. Then, 
only the cPACK or cNOPACK directives remain in effect for the 
file being read. Moreover, only those directives that immediately 
follow an internal EOR or EOF in the file being read are processed. 
If the file to be read is a binary file, it is recommended that the 
cTRANS directive be used. This is to ensure that binary data will 
hot be mistaken for a reformatting directive. If used, the cTRANS 
directive should immediately precede the cREAD directive in the 
submit file. 



cREWIND, 
Ifn 



c.EC=C2 



Requests that the system rewind file Ifn to the beginning- of- information. 
(BOI). If Ifn is not supplied, TAPEl is assumed. This directive is 
required only if the NR parameter is included in the SUBMIT command. 
Otherwise, file Ifn is automatically rewound. 

This directive is used in conjunction with the cREAD directive. Thus, 
if it is desired to rewind a file before the read operation begins, this 
directive must precede the cREAD directive in the submit file. 

Indicates that the escape code character is to be changed from c^ 
(current escape code) to 03 (new escape code). The new escape code iis 
used to recognize all subsequent reformatting directives until further 
change. 



ERROR PROCESSING 

If the user determines that an error occurred during processing of his job, he may 
reference a listing of the job dayfile as an aid in identifying the cause of the error. 
The job dayfile contains a record of the job processing activity and is disposed to the 
local batch queue or the EXPORT/IMPORT queue for printing when the job is terminated. 
However, all output is normally dropped at job termination when a batch job image is 
submitted from a time- sharing terminal. This includes the dayfile output as well as 
the job's output. In this event, the user can make provisions within his job to save 
the contents of the dayfile if an error in processing occurs. This is done by including 
the following control card images at the end of the job's control record (first record 
of the submit file). 



00562 EXIT. 

00563 DAYFILE, Ifn. 

00564 REPLACE(lfn) 
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When an error condition occurs during job processing, the system searches the job's 
control record for an EXIT card. If an EXIT card is found, the error condition is 
cleared and the control card images that follow are processed. In this ca^e, the 
contents of the job dayfile is copied to the working file specified by Ifn. That file 
is then saved for future reference. 

If an error does not occur during job processing, the EXIT card indicates where to 
terminate normal control card processing. 
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BATCH SUBSYSTEM 



The BATCH subsystem provides the time-sharing terminal user with a capability to 
enter KRONOS batch control card images as well as the standard time- sharing commands 
described in this manual. The control card images are entered and processed one at 
a time, and all output is returned to the terminal unless otherwise specified. Refer to 
the KRONOS Reference Manual for a description of the batch control cards available and 
information concerning their use. 

To enter the BATCH subsystem, the user types: 

BATCH, nnnnn 

Where: 

nnnnn Amount of field length required for the control card images to be 

entered. If nnnnn is not specified, a default value of 20000B is 
assumed. Note that an RFL control card image can be entered 
at any time to specify a new field length. 

Many of the system utilities and file manipulation control cards 
(for example, COPYBF and SKIFF) run at a predefined field length 
rather than the field length specified in the BATCH command. How- 
ever, all other control cards use the field length specified in the 
BATCH command or by a subsequent RFL control card. The field 
length required for the product set control cards (for example, 
COMPASS) is listed in the KRONOS Reference Manual. 

The system responds: 

$RFL, nnnnnn. (nnnnn is the specified field length) 

The user may then enter any valid batch control card image or time- sharing command. 
Time- sharing commands cannot be abbreviated under the BATCH subsystem; the entire' 
command or control card must be entered to be valid. The user may also end each 
control card with a period, but this is not required since the system automatically 
terminates each line of batch input with a period. If the command or control card is 
not valid or is entered incorrectly, the system responds: 

ILLEGAL CONTROL CARD. 

CATLIST and DEFINE permanent file commands are always processed as batch 
commands. 

The remaining permanent file commands are processed as time- sharing commands 
unless preceded by an X (refer to the following paragraphs), in which case they are 
also processed as batch commands. When a command is treated as a batch command, 
its operation will depend on a previously entered ACCOUNT card. 
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Initially, when a control card image is entered at the terminal, the time- sharing 
executive routine attempts to process it as a time- sharing command. Under the BATCH 
subsystem, if a command cannot be interpreted by the executive routine, it is passed 
to the system as a control card. A command that cannot be interpreted is either not 
in the time- sharing command set or is too complex to be processed by the executive 
routine. For example, the command 

GET, A 

is a valid time- sharing command and can be processed as such. However, the command 

GET, A, B, CD 

cannot be interpreted by the time-sharing executive routine and is thereby passed to the 
system for processing as a control card. If the user desires that a valid time- sharing 
command be processed as a control card, he may enter the following command (avail- 
able only under the BATCH subsystem): 

X, ccccccc 

This command allows the user to force a valid time- sharing command (ccccccc), 
normally interpreted by the executive routine, to be processed by the system as a 
control card. For example, to call the BASIC compiler, the user enters 

X, BASIC 
rather than the command 

BASIC 

which would change the subsystem from BATCH to BASIC. 

To exit from the BATCH subsystem, the user must type the entire name of one of the 
other subsystems (FORTRAN, BASIC, EXECUTE, or NULL). It is important to note 
that the user may also change the subsystem unintentionally by entering the OLD 
command. The OLD command is used to obtain a different primary file, but may 
also select the subsystem that was active when the specified file was originally saved. 
Refer to the description of the SAVE command in section 5 for additional information. 

NOTE 

Although a user can enter any batch control card 
from a time- sharing terminal, the output produced 
by several of these cards is formatted for trans- 
mission to a line printer (136 characters per line). 
Through use of the L072 control card, the user 
can format the output for transmission to a time- 
sharing terminal (72 to 150 characters per line). 
Refer to the description of the L072 control card 
in section 5 of the KRONOS Reference Manual. 
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KRONOS TERMINAL ERROR MESSAGES 



The following error messages may appear at the terminal. 



Message 
APPEND ERROR. 
BUFFER ARG. ERROR. 

CATALOG OVERFLOW - FILES. 

CATALOG OVERFLOW - SIZE. 

CHARGE FILE BUSY. 

CHARGE ILLEGAL AT THIS HOUR. 
CHARGE REQUIRED. 

COMMAND NOT UNIQUE. 
DEVICE UNAVAILABLE. 

DIRECT ACCESS DEVICE ERROR. 

EMPTY CATALOG. 

ERROR IN xxxxxx ARGUMENTS. 

ERROR IN FILE TYPE. 

ERROR IN MODE. 
ERROR IN PFILE ARGUMENTS. 
EXECUTE ONLY FILE. 
FILE NAME ERROR. 

FILE NAME MISSING. 
FILE NOT SORTED. 



FILE TOO LONG. 
60407600 B 



Description 

An error was encountered when appending a file. 

Address of information for permanent file manager 
was in error. 

User has exceeded the number of permanent files 
he is allowed. 

User has exceeded the mass storage area allowed 
for indirect access permanent files. 

File is not available for charge purposes; wait 
and try again. 

Project number used is not valid at this time of day. 

Charge number and project number required in order 
to complete log-in sequence. 

The characters supplied are not unique to one com- 
mand. 

User is attempting to access files on a device not 
available for access. 

User is attempting to DEFINE or ATTACH direct 
access permanent files on a device not available 
for access. 

No files exist for the options specified in a CATLIST 
command. 

The command string given contained a syntax error, 
xxxxxx is the name of the system program issuing 
the diagnostic. This is similar to ILLEGAL PARA- 
METER. 

File type specified was not recognized (for example, 
CT=SEMI instead of CT = SPRIV). 

Mode specified was not recognized. 

An argument for permanent file request was illegal. 

The user has only an E permission level on the file. 

The file name must contain only alphanumeric char- 
acters. 

A file name must be specified before a listing con- 
taining the permit information can be obtained with 
a CATLIST command. 

Primary file has one or more lines with nonnumerici 
line numbers. (Use SORT, If n command to obtain 
more detailed diagnostics. ) 

Limit for length of indirect access permanent file 
has been exceeded. »_^ 



FILE TOO LONG TO SORT. 

FL TOO SHORT FOR PROGRAM. 
ILLEGAL CHARGE. 

ILLEGAL COMMAND. 
ILLEGAL LIST OPTION. 

ILLEGAL LOGIN. 

ILLEGAL PARAMETER. 



ILLEGAL USER ACCESS. 



ILLEGAL WRITE ON APPEND 
ONLY FILE. 

ILLEGAL WRITE ON MODIFY 
ONLY FILE. 

ILLEGAL WRITE ON READ ONLY 
FILE. 

Ifn EMPTY. 

Ifn NOT ON MASS STORAGE. 

NO CONNECT TIME AVAILABLE. 

NO CPU TIME AVAILABLE. 

NO PRIMARY FILE. 

pfn ALREADY PERMANENT, 
pfn BUSY. 

pfn NOT FOUND. 



PERMISSION NOT GRANTED. 



Primary file is too long to be sorted automatically 
by the system. (Enter SORT, Ifn command to obtain 
more detailed diagnostics. ) 

Self explanatory; increase field length with RUN 
command (or RFL card in BATCH subsystem). 

Either charge or project number does not exist or 
the project number entered is not available to this 
user number. 

The command name entered is not a valid command. 

The list option specified in a CATLIST command is 
illegal. 

The validation ( VALID UX) file for the permanent file 
family specified is not present in this system. 

May indicate: 

• Parameter is outside legal bounds. 

• Parameter is not one of the acceptable 
sets for the command. 

• Parameter referenced does not exist. 

User has either attempted an operation that he has 
not been validated to perform or has exceeded his 
validation limits (refer to the LIMITS command in 
section 4). 

User has attempted to write on a permanent file 
with append-only permission to the file. 

User has attempted to write on a direct access file 
with modify-only permission to the file. 

User has attempted to write on a permanent file with 
read-only permission to the file. 

File contains no data. 

The user has attempted to save a file that does not 
reside on mass storage. 

Terminal connect time allowed under this project 
number has been expended. 

Central processor time allowed under this project 
number has been expended. 

The user has attempted an operation which requires 
a primary file when there was none defined. 

The specified file already exists (use REPLACE). 

The file to be attached is currently assigned to 
another user in conflicting mode. 

The permanent file specified does not exist. If this 
message occurs in response to the CATLIST command, 
pfn may specify a user number. 

The user does not have WRITE or APPEND per- 
mission on the specified permanent file. 
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PF UTILITY ACTIVE. 

PFM ILLEGAL REQUEST. 
RESERVED FILE NAME. 
TOO MANY PARAMETERS. 



Permanent file utility operation is currently taking 
place. Permanent file commands (OLD, LIB, GET, 
etc. ) are aborted. Control card images entered in 
the BATCH subsystem are placed on recall until 
the utility operation is complete. 

An illegal request was issued to the permanent file 
manager. 

File name is reserved by the system (for the user's 
protection). 

The user has submitted more parameters than the 
command allows. 



ERROR MESSAGE FOR SYSTEM MALFUNCTIONS 

The following messages indicate system error conditions; 



Message 
DATA BASE ERROR. 

ROLLIN FILE BAD. 



SYSTEM ERROR. 



Description 

An error in the structure of the validation file 
has been detected. Report this error to the com- 
puter center immediately. 

If this message is received, the user should log- 
off immediately. If he desires to continue, he may 
log-in again. The user should report this mal- 
function to the computer center and supply all 
terminal output since log- in, if possible. 

This error message should never appear. If it 
does, the user should report the malfunction to 
the computer center and supply all terminal output 
since log-in, if possible. 



I 
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DIAL-IN PROCEDURE AND CHARACTER SET B 



This appendix presents an explanation of how to connect an interactive terminal to the 
KRONOS Time-Sharing System. Also included are illustrations of typical keyboard 
configurations for terminals using either standard or A PL print, the function of certain 
control keys when connected to KRONOS, and finally, a list of the KRONOS character 
set. 

The procedure to connect the terminal to the system depends upon whether a data set or 
an acoustic coupler is being used to establish the connection. Both procedures are in- 
cluded in this appendix. Note that some terminals (most teletypewriter models) can 
include a data set or an acoustic coupler as an integral part of the terminal. 

It is recommended that the user read the instruction manual, generally supplied with the 
terminal, to become familiar with the operation of the terminal before connecting to 
KRONOS (that is, how to apply power, load paper, etc. ). 

CONNECTING TERMINAL USING A DATA SET 

If the data set is included as part of the terminal, proceed as follows: 

1. Apply power to the terminal (refer to appropriate instruction manual). A 
dial tone should be audible when power is applied. 

2. Dial the correct phone number. A short high pitched signal indicates that 
the call has been answered. 

If the data set is a stand-alone unit, proceed as follows: 

1. Apply power to the terminal (refer to appropriate instruction manual). 

2. Remove the data phone receiver from its cradle. 

3. Press the TALK key on the data set to obtain a dial tone. 

4. Dial the correct phone number. A constant high pitched signal indicates 
that the call has been answered. 

5. Press the DATA key on the data set (indicator in key should light), and 
replace the receiver in its cradle. 

CONNECTING TERMINAL USING AN ACOUSTIC COUPLER 

1. Apply power to the terminal (refer to appropriate instruction manual). 

2. Turn on the acoustic coupler (not required if the coupler is included as 
part of the terminal). 

3. Using a standard telephone, obtain a dial tone and dial the correct phone 
number. A constant high pitched signal indicates that the call has been 
answered. 

4. Place the receiver in the acoustic coupler. 
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Figure B-1 illustrates a typical terminal keyboard with standard print. 



• V Mr°Mr M 


( ' \ 


( 1 


P^'d^'d^ 


^ 


•^ 


V /wruN/tapeN /tape\ /^ 


"^r 


^/ 



nr 



REPT) (BREAK 



c 



SPACE BAR 



3 



Figure B-1. Teletype Model 33 Keyboard 



Figure B-2 illustrates a typical terminal keyboard with APL print. 



MAR 
REL 



TAB 
SET 



□ □ 

3 



mma 






BACK 
SPACE 




INDEX 



m B m m m m m m m 
m mm mm mm mill 



SPACE 



Figure B-2. Novar 5-41 Keyboard (APL Language) 



Table B-1 illustrates the function of certain terminal control keys when connected to 
the KRONOS Time-Sharing System. 
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TABLE B-1. TIME-SHARING TERMINAL CONTROL KEYS /FUNCTION 



Function 
(function of control key) 


Control Keys 


ASCII Code Terminals 
(typical) 


Correspondence Code Terminals 
(typical) 


Teletype 
33/35 


Teletype 
37/38 


CDC 713 
Display 


Memorex 
1240 


IBM 
2741 


Novar 
5-41 


Datel 
30 


Delete current input line 


ESC 


ESCAPE 


ESCAPE 


ESC 


ATTN 


ATTN 


ATTN 


Backspace 


Underline 

or 
Backarrow 


Underline 


Underline 


Underline 


BACKSPACE 


BACKSPACE 


BACKSPACE 


Enter text mode 


TEXT 
command 


TEXT 
command 


TEXT 
command 


TEXT 
command 


TEXT 
command 


TEXT 
command 


TEXT 
comm^and 


Exit text mode 


BREAKt 


INTRPTt 


BREAKt 


INTt 


ATTNt 


ATTNt 


ATTNt 


Interrupt program 
(during output) 


BREAK 

or 

I key 


INTRPT 
or 
I key 


BREAK 
or 

I key 


INT 

or 

I key 


ATTN 


ATTN 


ATTN 


Interrupt program 
(no output) 


BREAK 


INTRPT 


BREAK 


INT 


ATTN 


ATTN 


ATTN 


Terminate program 
(during output) 


S key 


S key 


S key 


S key 


ATTN 


ATTN 


ATTN 


Terminate program 
(no output) 


STOP 
command 


STOP 
command 


STOP 
command 


STOP 
command 


STOP 
command 


STOP 
command 


STOP 
command 


Punch leader on paper tape 


RUB OUT 


DELETE 


NA 


NA 


NA 


NA 


NA 


t Effective only when entered in first character position of line (empty input line) 
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CENTRAL MEMORY CHARACTER EQUIVALENTS 

The manner in which characters entered from the terminal are interpreted by the system 
depends upon whether the user has specified that the characters belong to the full ASCII set 
(refer to the description of the ASCII command in section 4). For example, if the user 
enters the following characters to be mapped into the full ASCII set (128 characters recognized): 

aAbBcCdDeE 
the central memory equivalent (in display code) is as follows: 



59 




47 




35 




23 




11 


{ 


76 


01 


01 


76 


02 


02 


76 


03 


03 


76 


04 


04 


76 


05 


05 


55 


00 


00 


00 


00 



■Bit position (60- bit 
central memory word) 



However, if the characters are mapped into the subset of the ASCII character set used 
during NORMAL operation (61 characters recognized), the central memory equivalent 
(in display code) is as follows: 



59 



47 



35 



23 



11 







01 01 I 02 02 I 03 03 | 04 04 | 05 05 | 



Characters entered under control of the BINARY command are not translated into dis- 
play code. It makes no difference if the ASCII command is in effect (128 characters 
recognized) or the characters are entered during NORMAL operation (61 characters 
recognized). However, each 8-bit character is weighted by a value of 4000B. For 
example, if the user enters the following characters and the BINARY command is in 
effect: 

aAbBcCdDeE 

the central memory equivalent is as follows: 



59 


47 


35 


23 


11 C 


4 3 4 1 


4 10 1 


4 3 4 2 


4 10 2 


4 14 3 


4 3 3 


4 3 4 4 


4 10 4 


4 14 5 


4 3 5 



The characters illustrated are entered from an ASCII code terminal although a 
correspondence code terminal may also be used. 

Table B-2 lists the KRONOS characters sets, indexed by 6000 internal display code. 
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TABLE B-2. KRONOS CHARACTER SETS - TERMINAL /INTERNAL DISPLAY 



ASCII CODE TERMINALt 


CORRESPONDENCE 


CODE 


TERMINALtt 


6000 
INTERNAL 


ASCII CODE TERMINAL 


CORRESPONDENCE 


CODE TERMINAL 


6000 

INTERNAL 

DISPLAY CODE 

(6/12-BIT OCTAL) 


STANDARD PRINT 


APL PRINT 


STANDARD PRINT 


APL PRINT 


STANDARD PRINT 


APL PRINT 


STANDARD PRINT 


APL PRINT 


CHAR. 


CODE 
(8-BIT OCTAL) 


CHAR. 


CODE 
(B-BIT OCTAL) 


CHAR. 


CODE 
(7-BIT OCTAL) 


CHAR. 


CODE 
(7-BIT OCTAL) 


DISPLAY CODE 
(6/12-BIT OCTAL) 


CHAR. 


CODE 
(8-BIT OCTAL) 


CHAR. 


CODE 
(8-BIT OCTAL) 


CHAR. 


CODE 
(7-BIT OCTAL) 


CHAR. 


CODE 
(7-BIT OCTAL) 


NULL 




NULL 




NULL 




NULL 




00 


(SPACE) 


240 


(SPACE) 


240 


[SPACE) 


100 


(SPACE) 


100 


55 


A 


10 1 


A 


34 1 


A 


171 


A 


171 


1 


, 


254 


, 


254 




073 


, 


073 


56 


B 


102 


B 


342 


B 


166 


B 


166 


02 




056 




056 




121 




121 


57 


C 


303 


C 


143 


C 


172 


C 


172 


03 


" 


042 




041 




1 II 




040 


60 


D 


104 


D 


344 


D 


052 


D 


052 


04 


C 


333 


C 


273 


1/4 


001 


C 


153 


6 1 


E 


305 


E 


145 


E 


1 12 


E 


112 


5 


] 


335 


1 


072 


W 


001 


] 


111 


62 


F 


306 


F 


146 


F 


163 


F 


163 


6 




072 




276 




153 




121 


63 


6 


107 


G 


347 


G 


043 


G 


043 


07 


' 


047 


' 


1 13 


' 


1 1 1 


' 


032 


64 


H 


1 10 


H 


350 


H 


046 


H 


046 


1 


a 


246 


X 


134 


a 


150 


X 


023 


65 


I 


31 1 


I 


151 


I 


031 


I 


031 


1 1 


CR 


215 


CR 


215 


NULL 




NULL 




66 


J 


312 


J 


152 


J 


103 


J 


103 


1 2 


LF 


012 


LF 


012 


LF 


156 


LF 


156 


67 


K 


1 13 


K 


353 


K 


032 


K 


032 


1 3 


t 


336 


- 


042 


NULL 




- 


020 


70 


L 


314 


L 


154 


L 


106 


L 


106 


14 


# 


243 


t 


336 


# 


160 


/ 


070 


71 


M 


115 


M 


355 


M 


141 


M 


141 


15 


< 


074 


< 


243 


NULL 




< 


160 


72 


N 


116 


N 


356 


N 


122 


N 


1 22 


16 


> 


276 


> 


047 


NULL 




> 


1 50 


73 





317 





157 





105 





105 


17 


(ESC 1) 




NULL 




NULL 




NULL 




74 


P 


120 


P 


360 


P 


013 


P 


013 


20 


7 


077 


7 


321 


? 


007 


? 


133 


75 


Q 


321 


Q 


161 


Q 


133 


Q 


133 


21 


(ESC 2) 




NULL 




NULL 




NULL 




76 


R 


322 


R 


162 


R 


051 


R 


051 


22 




273 




074 


; 


153 


; 


073, 


77 


S 


123 


S 


363 


S 


045 


S 


045 


23 


NULL 




NULL 




NULL 




NULL 




7600 


T 


324 


T 


164 


T 


002 


T 


002 


24 


a 


. 341 


a 


101 


a 


171 


a 


171 


7601 


U 


125 


U 


365 


U 


062 


U 


062 


25 


b 


342 


I 


102 


b 


166 


i 


166 


7602 


V 


126 


V 


366 


V 


061 


V 


061 


26 


c 


143 


n 


303 


c 


172 


n 


172 


76 03 


w 


327 


w 


167 


w 


165 


w 


165 


27 


d 


344 


L 


104 


d 


052 


L 


052 


76 04 


X 


330 


X 


1 70 


X 


142 


X 


142 


30 


e 


145 


€ 


305 


e 


1 12 


< 


1 12 


7605 


Y 


131 


Y 


371 


Y 


147 


Y 


147 


31 


f 


146 


A 


137 


f 


163 


_ 


163 


7606 


z 


132 


z 


372 


z 


124 


z 


124 


32 


g 


347 


V 


107 


g 


043 


7 


043 


7607 





060 





060 





144 





144 


33 


h 


350 


A 


110 


h 


046 


A 


046 


76 10 


1 


26 1 


1 


261 


1 


040 


1 


040 


34 


i 


151 


\ 


311 


1 


03 1 


\ 


031 


76 1 1 


2 


262 


2 


262 


2 


020 


2 


020 


35 


i 


152 


o 


312 


i 


103' 





103 


7612 


3 


063 


3 


063 


3 


160 


3 


160 


36 


K 


353 


«- 


100 


k 


032 


< 


004 


7613 


4 


264 


4 


264 


4 


04 


4 


004 


37 


1 


154 


D 


314 


1 


106 


a 


106 


76 14 


5 


065 


5 


065 


5 


010 


5 


010 


40 


m 


355 


— 


134 


m 


141 


1 


141 


76 15 


6 


066 


6 


066 


6 


130 


6 


130 


41 


n 


356 


T 


116 


n 


122 


T 


122 


76 16 


7 


267 


7 


267 


7 


150 


7 


150 


42 





157 





317 





105 





105 


76 17 


8 


270 


8 


270 


8 


070 


8 


070 


43 


P 


360 


< 


044 


P 


013 


> 


130 


7620 


9 


071 


9 


07 1 


9 


064 


9 


064 


44 


q 


161 


> 


246 


q 


133 


? 


133 


7621 


+ 


053 


+ 


055 


+ 


023 


+ 


067 


45 


r 


162 


P 


322 


r 


051 


P 


051 


7622 


- 


055 


- 


275 


- 


067 


- 


067 


46 


s 


363 


r 


123 


s 


045 


r 


045 


7623 


* 


252 


* 


120 


* 


070 


« 


013 


47 


t 


164 


* 


050 


t 


002 


~ 


002 


76 24 


/ 


257 


/ 


257 


/ 


007 


/ 


007 


50 


u 


365 


4 


125 


u 


062 


i 


062 


7625 


( 


050 


( 


053 


( 


064 


( 


153 


51 


V 


366 


u 


126 


V 


061 


u 


061 


7626 


) 


251 


) 


252 


) 


144 


) 


III 


52 


w 


167 


0) 


327 


w 


165 


u 


165 


7627 


$ 


044 


$ 


176 


$ 


004 


a 


171 


53 


X 


170 


3 


330 


X 


142 


3 


142 


76 30 


= 


275 


= 


245 


= 


023 


= 


010 


54 


y 


371 


t 


131 


y 


147 


t 


147 


7631 



t THE OCTAL CODES LISTED FOR ASCII CODE TERMINALS ARE SHOWN WITH EVEN PARITY (NORMAL) 
tt THE OCTAL CODES LISTED FOR CORRESPONDENCE CODE TERMINALS ARE SHOWN WITH ODD PARITY (NORMAL) 



t3d 



w 



TABLE B-2. KRONOS CHARACTER SETS - TERMINAL /INTERNAL DISPLAY (Cont'd) 



05 
O 

o 
-J 

o 
o 



ASCII CODE TERMINAL 


CORRESPONDENCE CODE 


TERMINAL 


6000 

INTERNAL 

DISPLAY CODE 

(6/12-BIT OCTAL) 


STANDARD PRINT 


APL PRINT 


STANDARD PRINT 


APL PRINT 


CHAR. 


CODE 
(8-BIT OCTAL) 


CHAR. 


CODE 
(8-BIT OCTAL) 


CHAR. 


CODE 
(8-BIT OCTAL) 


CHAR. 


CODE 
(8-BIT OCTAL) 


z 


372 


c 


132 


z 


124 


c 


124 


7632 


DLE 


220 


DLE 


220 


NULL 




NULL 




7633 


BELL 


207 


BELL 


207 


NULL 




NULL 




7634 


DC2 


022 


DC2 


022 


NULL 




NULL 




7635 


ETX 


003 


ETX 


003 


NULL 




NULL 




7636 


DC4 


024 


DC4 


024 


NULL 




NULL 




7637 


NAK 


225 


NAK 


225 


NULL 




NULL 




7640 


SYN 


226 


SYN 


226 


NULL 




NULL 




7641 


ETB 


027 


ETB 


027 


NULL 




NULL 




7642 


CAN 


030 


CAN 


030 


NULL 




NULL 




7643 


EM 


231 


EM 


231 


NULL 




NULL 




7644 


VT 


213 


VT 


213 


NULL 




NULL 




7645 


SOH 


201 


SOH 


201 


NULL 




NULL 




7646 


1 


041 


V 


251 


NULL 




NULL 




76 47 


SI 


017 


SI 


017 


NULL 




NULL 




7650 


BS 


210 


BS 


210 


BS 


135 


BS 


135 


7651 


HT 


01 1 


HT 


01 1 


HT 


057 


HT 


057 


7652 


EOT 


204 


EOT 


204 


NULL 




NULL 




7653 


GS 


035 


GS 


035 


NULL 




NULL 




7654 


NUL 


000 


NUL 


000 


NUL 


075 


NUL 


075 


7655 


FF 


014 


FF 


014 


, 


073 


NULL 




7656 


SO 


216 


SO 


216 




12 1 


NULL 




7657 


STX 


202 


STX 


202 


NULL 




NULL 




7660 


{ 


173 




140 


NULL 




— 


00 1 


7661 


} 


175 




374 


NULL 




— 


00 1 


7662 


SUB 


232 


SUB 


232 


NULL 




NULL 




7663 


ACK 


006 


ACK 


006 


NULL 




NULL 




7664 


a 


246 


NULL 




NULL 




NULL 




7665 


\ 


134 


\ 


077 


NULL 




\ 


007 


7666 




174 


1 


1 15 


« 


130 


1 


141 


7667 


~ 


176 


~ 


324 


± 


040 


~ 


002 


7670 


# 


243 


NULL 





NULL 




NULL 




7671 


FS 


234 


FS 


234 


NULL 




NULL 




7672 


RS 


036 


RS 


036 


NULL 




NULL 




7673 


DEL 


377 


DEL 


377 


NULL 




NULL 




7674 


US 


237 


US 


237 


NULL 




NULL 




7675 


NL 




NL 




NL 


155 


NL 


155 


7676 


ESC 


033 


ESC 


033 


NULL 




NULL 




7677 


NULL 




NULL 





NULL 




NULL 




7400 


O 


300 


X 


175 


o 


020 


A 


144 


7401 


% 


245 


+ 


173 


% 


010 


+ 


023 


7402 


\ 


140 


* 


335 


NULL 




V 


064 


7403 




137 t 




306 




067 


NULL 




7404 


X-ON 


021 


X-ON 


02 1 


NULL 




NULL 




7405 


X-OFF 


223 


X-OFF 


223 


NULL 




NULL 




7406 


ENQ 


005 


ENQ 


005 


NULL 




NULL 




7407 



t ON TTY MODELS HAVING NO UNDERLINE, THE BACKARROW (-) TAKES ITS PLACE. 



PAPER TAPE OPERATIONS 



Paper tape is used for preparing input off-line (when time is not charged) and entering 
it on-line (when time is charged). This ensures accuracy and speed when most needed. 
An input tape can include programs, data, and commands. Accordingly, it is possible 
for the entire terminal operation, after log-in, to be run from paper tape. 

This exposition assumes a typical teletypewriter (model 33) with a paper tape punch 
and a paper tape reader. 

The paper tape punch has four buttons with the following labels and use. 

ON Turns the punch on 

OFF Turns the punch off 

REL. Releases the feedwheel so one can freely move the tape through 

the punch head 

B.SP. Backspaces the tape one row of holes each time it is pressed. 

This is used to make corrections when preparing a tape off-line 
(refer to detailed description later in this appendix). 

The paper tape reader has one switch with four positions. Their labels and use are 
as follows: 

START Momentarily pressing the switch to this uppermost position starts 

the reader. The switch snaps back to the AUTO position and 
reading continues. 

STOP Reading stops immediately whenever the switch is moved to this 

position. 

AUTO This position is used in conjunction with the input and processing 

of commands and data in tape mode (tape mode is explained later 
in this appendix). It allows the tape reader to be turned off and 
on so that processing of each command or line of data can be 
completed before additional input is entered. 

FREE Releases the feedwheel so one can freely slide the tape in and 

out of the read head. 

NOTE 

On teletypewriters lacking an AUTO 
position, reading must be manually 
restarted each time it has been stopped. 

CONTROL CHARACTERS 

Each line of input from paper tape niust end with a particular sequence of control 
characters. These are punched by functional keys on the teletypewriter keyboard. 
The control characters used with paper tape are as follows. 

CR Carriage return. This is the RETURN key on the keyboard. It 

moves the print head back to the beginning of the line and informs 
the system that this line of input is completed. 
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LF Line feed. This is the LINE FEED key on the keyboard- It 

advances the paper roller one line. In normal mode, the system 
sends back a signal that initiates this feed; in tape mode, this 
signal is not sent and is therefore required on tape. 

CTRL/ X-OFF. The appearance of this character on the tape during 

X-OFF reading turns the tape reader off. This character is punched by 

holding down the CTRL key and pressing the X-OFF key. 

RO(n) Rubout. This is the RUB OUT key on the keyboard. It punches 

a full row of holes. This row is interpreted as null by the system 
and hence this character is used for spacing and overpunching 
errors. The n parameter specifies the minimum number of times 
this character should be punched in sequence. 

INPUT LINES 

The following line formats are used to enter programs, data, and commands. The 
left half of the page shows an example of the input and the right half shows the con- 
trol characters that immediately follow the last input character. It should be noted 
that each line is terminated with three rubouts to provide separation from the next 
line. While it is possible that adequate separation may be provided with less than 
three rubouts, this is the recommended number. (The system punches three rubouts 
at the end of each line when a tape is produced on-line. ) 

PROGRAM LINE 

100 PROGRAM TEST (INPUT, OUTPUT) - - CR LF RO(3) 

UATA LINE 

? 12.44,18.31,29.08 - - CR LF CTRL/X-OFF RO(3) 

The ? is supplied by the system^ The remainder of the line comes from the tape. 
The X-OFF turns the reader off to allow this data to be processed before the next 
line is read. 

COMMAND LINE 

CATLIST/LO=F - - CR LF CTRL/X-OFF R0(3) 

The X-OFF turns the reader off to allow processing of the command to be completed 
before the next line is read. 

PUNCHING A PAPER TAPE OFF-LINE 



The following procedure is used to punch a tape when the teletypewriter terminal is 
not logged-in. 

1. Turn the teletypewriter on in local /mode by pressing the LCL button 
below the phone dial. 

2. Turn the paper tape punch on by pressing the ON button located on the 
punch. 
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3. Prepare a tape leader of about 30 rubouts (3 inches) by pressing the 
RUB OUT and repeat (REPT) keys together. 

4. With a pencil, trace the arrow above the punch output onto the tape. This 
will identify the start of the tape for reading. (It is possible to put the 
tape in the reader backwards. ) 

5. Type in the input lines with their appropriate control characters. 

6. Add a 3 -inch trailer of rubouts and tear the tape off. 

7. Press the CLR button below the phone dial to turn the teletypewriter off. 

TAPE MODE 

To read and process data and commands from tape, it is necessary that the tape 
reader be turned off and on to allow time for processing. By entering tape mode, 
the user enables the system to synchronize tape input with its processing. This mode 
also inhibits the output of header messages and the READY message when LIST 
(or LNH) is used to punch a tape on-line (refer to Punching a Tape On-line). It 
should be noted that carriage return (CR) entered on an empty input line will be 
ignored by the system while in tape mode. 

The user enters tape mode by typing the TAPE command and pressing the carriage 
return key. The system acknowledges entry into this mode by advancing the printout 
paper one line. It will not print READY. If the reader switch has been in the AUTO 
position, reading begins automatically; if the reader switch was in the OFF position, 
reading does not begin until manually initiated by momentarily moving the switch to 
START. All subsequent commands and data entries are acknowledged by the one-line 
advancement without the printout of READY. 

The user exits from tape mode by typing the NORMAL command and pressing the 
carriage return key. 

PUNCHING A TAPE ON-LINE 



To punch a tape with information already contained in a system file, the following 
procedure is followed. 

1. If not logged-in, log-in. 

2. If not in tape mode, type TAPE and press the carriage return key. 

3. Turn the punch on. 

4. Run a leader of rubouts. 

5. Type in LIST if the primary file is to be punched; type in LIST,F=lfn if a 
working file other than the primary file is to be punched. (The short form 
LNH is permissible. ) 

6. Press the carriage return key. The file will be listed and punched 
simultaneously. The system will add the appropriate control characters 
at the end of each line. 

7. Run a trailer of rubouts. 
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CORRECTIONS 

While punching a tape off-line, corrections can be made by backspacing over the in- 
correct punch (use the B.SP. button on the punch) and punching a rubout over the 
error (use the RUB OUT key on the keyboard). Then punch in the correct character. 

It is also possible to make corrections by using the back arrow as in normal, on-line 
operation. However, the error and arrow will appear in the printout. Likewise, when 
line numbers are being used, an erroneous line can be retyped (and repunched) with the 
same line number. Again, the erroneous and correct version will appear in printout 
although the system will recognize only the correct version during processing. 



Commands and input are 



Example: 

In this example, the input tape contains only program lines, 
typed in by the user before and after the tape is read in. 

The tape as punched is shown below. The left half of the page gives the printed copy 
which was produced as the tape was punched; the right half of the page- shows the 
control characters which were entered at the end of each line but were not printed. 

100 LET FACTOR=l 

110 INPUT N 

120 FOR 1 = 1 TO N 

130 LET FACTOR=FACTOR*I 

140 PRINT FACTOR 

150 NEXT I 

160 END 

To demonstrate the use of this tape, it is assumed the user is logged-in under the 
NULL subsystem. He positions this tape in the xeader and sets the reader switch 
to AUTO. The following is the printout that results from the interaction of user and 
tape with the terminal. The right half of the page contains explanations of the action. 



RO(30) 




CR 


LF 


RO(3) 


CR 


LF 


RO(3) 


CR 


LF 


RO(3) 


CR 


LF 


RO(3) 


CR 


LF 


RO(3) 


CR 


LF 


RO(3) 


CR 


LF 


RO(30) 



BASIC " 

READY. 

NEW, FACT 1 
READY. 



TAPE 



100 LET FACTOR = l 

110 INPUT N 

120 FOR 1 = 1 TO N 

130 LET FACTOR=FACTOR-I 

140 PRINT FACTOR 

150 NEXT I 

160 END 

RNH " 



ILLEGAL STATEMENT AT 100 
ILLEGAL STATEMENT AT 130 
ILLEGAL STATEMENT AT 140 



By typing in this command, the user 
enters the BASIC subsystem. 

This line is typed in to establish a 
new primary file with the name FACTl 

The command TAPE is typed in, and as 
soon as the carriage return takes effect, 
the tape reader goes on and the entire 
tape (seven lines) is read in. 
The reader runs through the trailer of 
rubouts and then turns itself off. 



Types in RNH and receives the diagnostics 
shown. BASIC variables cannot be more 
than two characters. 



C-4 
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CP 



0.015 SECS. 



RUN COMPLETE. 



100 LET F = l 
130 LET F=F*I 
140 PRINT F 
RNH. 



? 5 

1 

2 

6 

24 

120 



Types in the corrective coding shown. 

Initiates another run. 

The system replies with ? 

He types in 5 and receives the 

desired printout. 



CP 



0.017 SECS. 



RUN COMPLETE. 



LIST^;^ 

100 LET F = l 

110 INPUT N 

120 FOR 1 = 1 TO N 

130 LET F=F*I 

140 PRINT F 

150 NEXT I 

160 END 



Example: 



The user wants to punch a new tape con- 
taining this corrected program. He types 
in LIST but does not press the carriage 
return key. He turns on the punch, runs 
off some leader, and then enters the 
carriage return. As the system prints the 
listing, it also punches a tape with the 
same information along with the control 
characters CR, LF, and RO(3) at the end 
of each line. After this, the user punches 
a trailer of rubouts and tears off the 
new tape. He discards the original tape. 



In this example, the input tape contains not only a program but commands to execute, 
list, modify, and save that program, as well as the input data used by that program. 



The complete tape as punched is shown below. The left half of the 
printed copy which was produced as the tape was punched; the right 
shows the control characters which were entered at the end of each 
printed. 



page gives the 
half of the page 
line but were not 





RO(30) 






FORTRAN 


CR 


LF 


CTRL/X-OFF 


R0(3) 


NEW, DEMO 


CR 


LF 


CTRL/X-OFF 


RO(3) 


100 PROGRAM DEMOdNPUT, OUTPUT) 


CR 


LF 


RO(3) 




110 DIMENSION 11(5) 


CR 


LF 


RO(3) 




120 READ 10, (II(J),J = 1,5) 


CR 


LF 


RO(3) 




130 10 FORMAT(5I5) 


CR 


LF 


RO(3) 




140 PRINT 20, (II(J), J = l,5) 


CR 


LF 


RO(3) 




150 20 FORMAT(5I10) 


CR 


LF 


RO(3) 




160 END 


CR 


LF 


RO(3) 




RNH 


CR 


LF 


CTRL/X-OFF 


RO(3) 


1111122222333334444455555 


CR 


LF 


CTRL/X-OFF 


RO(3) 


SAVE, DEMO =TA PE 1 


CR 


LF 


CTRL/X-OFF 


RO(3) 


135 DO 1 1 = 1,5 


CR 


LF 


RO(3) 




137 II(I)=n(I)+4444 


CR 


LF 


RO(3) 




139 1 CONTINUE 


CR 


LF 


RO(3) 




RESEQ, 100,5 


CR 


LF 


CTRL/X-OFF 


RO(3) 


LIST 


CR 


LF 


CTRL/X-OFF 


RO(3) 


RNH 


CR 


LF 


CTRL/X-OFF 


RO(3) 


1111122222333334444455555 


CR 


LF 


CTRL/X-OFF 


RO(3) 


REPLACE, DEMO =T A PEl 


CR 


LF 


CTRL/X-OFF 


RO(30) 
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To execute this tape, the user logs in, positions the tape in the reader, sets the reader 
switch to AUTO, types in TAPE, and upon pressing the carriage return key, starts the 
reading of tape. He then observes the remainder of the action without intervention. 



The following is the printout of the execution of the tape, 
contains explanations of the action. 



The right half of the page 



FORTRAN *- 



NEW, DEMO 



100 PROGRAM DEMOdNPUT, OUTPUT) 

110 DIMENSION 11(5) 

120 READ 10, (II(J).J = 1,5) 

130 10 FORMAT(5I5) ^ 

140 PRINT 20, (II(J), J = l,5) 

150 20 FORMAT(5I10) 

160 END 

RNH- 



When this line is read, the reader 
stops. As soon as FORTRAN is 
established as the current subsystem, 
the system turns the reader back on. 

When this line is read, the reader stops. 
After a new primary file called DEMO 
is established, the system turns the 
reader back on. 



The seven lines of the program are 
read in without interruption. 



The command to run the program is read 
in and the reader turned off. 



? 1111122222333334444455555- 



11111 



22222 



33333 



Processing reaches the READ statement 

(line 120) and the system prints ?. 
The system then turns the reader back 
on and the line of data is read in. 
Then the reader is turned off to allow 
data processing. 

Resultant printout 

44444 55555 



END. 



CP 0. 130 SECS. 

RUN COMPLETE. 
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SAVE, DEMO =TAPE1 



This command is read in and the reader 
turned off. A copy of the program demo 
is made an indirect access permanent 
file with the name TAPEl. Then the 
reader is turned back on. 



135 DO 1 1 = 1,5 
137 II(I)=II(I)+4444 
139 1 CONTINUE 



RESEQ, 100, 5 



CP 



LIST - 



0.019 SECS. 



These three lines of modification are 
read in from the tape without 
interruption. 

The RESEQ command is read in and the 

reader turned off. When resequencing 
is accomplished according to specifi- 
cations, the reader is turned back on. 

This command is read from tape and the 

tape reader turned off. Then the system 
00100 PROGRAM DEMO(INPUT, OUTPUT) lists the primary file which contains 
00105 DIMENSION 11(5) the above modifications and resequenced 

OOMO READ 10, (II(J), J=l, 5) format. When the listing is completed, 

00115 10 FORMAT(5I5) the reader is turned on again. 

00120 DO 1 1 = 1,5 
00125 II(I)=II(I)+4444 
00130 1 CONTINUE 
00135 PRINT 20, (IKJ), J = l,5) 
00140 20 FORMATCSIIO) 
00145 END 



RNH 



? 1111122222333334444455555 



15555 



26666 



37777 



END. 



— This command is read in, the reader 
turned off, and the modified program 
executed. The system prints the ? 
and then turns the reader on. The 
line of data is read in from the tape 
and the reader turned off. The data 
is processed and results printed. 

48888 59999 



CP 0. 141 SECS. 

RUN COMPLETE. 

REPLACE, DEMO =TAPE1 - 



This last command is read in and the reader 
turned off. A copy of this revised version 
of DEMO replaces the old one that was 
made an indirect access permanent file 
under the name TAPEl. It is now 
the indirect access permanent file that 
is referenced by the name TAPEl. 

The reader is turned back on. It runs 
through the trailer of rubouts and then 
turns itself off. 

If, at this point, the user has no more 
tapes to run, he should exit tape mode by 
issuing the NORMAL command. 
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MASS STORAGE DEVICE STATISTICS 



The following list describes the mass storage devices supported by KRONOS and the 
size of blocks allocated for direct access files. 



Block Size 



Device Code 


Device 


DA 


6603 Disk System 


DB 


6638 Disk System 


DC 


863 Drum Storage 


DDn 


854 Disk Storage Drive 
(1 < n < 8) 


DE 


Extended Core Storage 


DF 


814 Disk File 


DH 


821 Data File 


Din 


844 Disk Storage Sub- 
system (1 < n < 8) 


DP 


Distributive Data Path 


MDn 


841 Multiple Disk Drive 



PRUs 



CM Words 



Characters 



(1 < n < 8) 



50; 64 


3200; 4096 


32000; 40960 


49 


3136 


31360 


25 


1600 


16000 


n*26 


n*1664 


n* 16640 


16 


1024 


10240 


85 


5440 


54400 


320 


20480 


204800 


n^!a07 


n-^6848 


n*68480 


16 


1024 


10240 


n*32 


n*2048 


n=!=20480 



In this table, n indicates the unit count for multiunit devices. 

If the user's validation permits (refer to LIMITS command, section 4), the maximum 
size indirect access file is determined by the device limit less the space allocated 
for catalog information and other files. 

The size of a direct access file is limited only by the device; there are no system 
limitations. 
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TEXT EDITOR COMMAND INDEX 



This is a list of the commands available under Text Editor, 
tion, refer to the Text Editor (EDIT) Reference Manual. 



For additional informa- 



LIST(S) 

LIST(S);n 

LIST(S): /string/ 

LIST(S):/ string/ ;n 

LIST(S):/stringl/, /string2/ 

LIST(S):/stringl/, /string2/;n 

FIND(S);n 

FIND (S):/ string/ ;n 

FIND(S):/stringl/, /string2/;n 

SET,n 

SET,-n 

SET: /string/ 

SET: /string/ ;n 

RESET 

ADD(S) 

ADD(S);n 

ADD(S):/ string/ 

ADD(S):/ string/ ;n 

ADD(S):/stringl/, /string2/ 

ADD(S):/stringl/, /string2/;n 

INSERTS :/stringl/, /string2/;n 

DELETE(S) 
DELETE(S);n 
DELETE(S):/ string/ 
DELETE(S):/ string/ ;n 
DELETE(S):/stringl/, /string2/ 
DELETE{S):/stringl/, /string2/;n 

BLANK(S) 

BLANK(S);n 

BLANK(S): /string/ 

BLANK(S ) : / string/ ;n 

BLANK(S):/stringl/, /string2/ 

BLANK(S):/stringl/, /string2/;n 

CHANGE (S) 
CHANGE(S);n 
CHANGE(S): /string/ 
CHANGE(S): /string/ ;n 
CHANGE(S):/stringl/, /string2/ 
CHANGE(S):/stringl/, /string2/;n 



REPLACES: /string/ ;n 
REPLACES: /stringl/, /string2/;n 

CLEAR 

EXTRACT (S) 
EXTRACT(S);n 
EXTRACT (S): /string/ 
EXTRACT (S):/ string/ ;n 
EXTRACT(S): /stringl/, /string2/ 
EXTRACT(S): /stringl/, /string2/;n 

LENGTH;n 

LINE 

WIDTH;n (6 < n < 149) 

ALIGN 

ALIGN;n 

ALIGN: /string/ 

ALIGN:/ string/ ;n 

ALIGN: /stringl/, /string2/ 

ALIGN: /stringl/, /string2/;n 

DEFTAB 
DEFTAB:/tabchar/ 

TAB:/tj,...,t^/ 

LISTAB 

MERGE: /lfn/;n 
MERGE: /Ifn/, /string/;n 

NUMBER(S) 
NUMBER(S): /string/ 
NUMBER(S): /stringl/, /string2/ 

END 
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RESERVED FILE NAMES 



Several file names are reserved for system use or have special significance to the 
system. These reserved names protect the user from accidentally destroying some 
of his own files. The message RESERVED FILE NAME, indicates that the user has 
attempted to use one of these file names. 

The reserved file names are: 

INPUT 

OUTPUT 

PUNCH 

PUNCHB 

P8 

SCR 

SCRl 

SCR2 

SCR3 

SCR4 

An attempt is not always made to prevent the use of these file names. Many of the 
6000 product set members, such as the COMPASS assembler, use other scratch files 
in addition to those listed. A user should consult the appropriate reference manuals 
for a complete list of these files. System integrity does not depend on preventing the 
use of these reserved file names. 
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SAMPLE SESSION AT THE TERMINAL 



This appendix presents a typical interaction of a beginning user with the KRONOS Time- 
Sharing System. After log- in, the user tries basic operations in the various sub- | 
systems and tests a cross section of the commands available. 

The left half of the page is the terminal (Teletype model 33) printout of the interaction. 
The right half of the page gives explanations. In a few places the terminal printout has 
been vertically expanded to allow spacing for the inclusion of the relevant comments. 



72/12/28. 10.34.14. 
KRONOS TIME SHARING SYSTEM 
USER NUMBER: USER 123 
PASSWORD 



TERMINAL: 40, TTY 

RECOVER/SYSTEM: NULL - 
OLD, NEW, OR LIB FILE: 
READY. 



VER. 2.1 



NEW, TEST 



The user intends to create a primary 
file that he will use for experimental 
purposes. He will preserve this file 
as an indirect access permanent file. 
However, he does not want a particular 
subsystem associated with the file. 
Accordingly, he enters the NULL 
subsystem. 



TEXT * 
ENTER 



LINE 
LINE 
LINE 
LINE 
LINE 
LINE 
LINE 
LINE 
LINE 
LINE 



TEXT MODE 
1: ABCDEFGHIJ 
2: BCDEFGHIJK 
3: CDEFGHIJKL 

4: DEFGHIJKLM 

5: EFGHIJKLMN 

6: FGHIJKLMNO 

7: GHIJKLMNOP 

8: HIJKLMNOPQ 

9: IJKLMNOPQR 

10: JKLMNOPQRS 



•User enters text mode because the source 
data to be entered will not have line 
numbers. 



Types in an array of alphanumeric 
characters to be used in testing the 
Text Editor. 



EXIT TEXT MODE. *" 



User exits text mode by pressing the 
"BREAK key. 
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LIST,R 
LINE 1 
LINE 2 
LINE 3 
LINE 4 
LINE 5 
LINE 6 
MNO 
LINE 7 
LINE 8 
LINE 9 
LINE 10 
--EOR-- 
READY. 



ABCDEFGHIJ 
BCDEFGHIJK 
CDEFGHIJKL 
DEFGHIJKLM 
EFGHIJKLMN 
FGHIJKL--EOR-- 

GHIJKLMNOP 
HIJKLMNOPQ 
IJKLMNOPQR 
: JKLMNOPQRS 



Remembers that Text Editor can 
only operate on a single record. 
He suspects he has created more 
than one record and calls for a 
listing with end-of-record marks. 

His suspicions are confirmed. 



PACK - 
READY. 



The PACK command compresses the 
file into one record. 



LNH,R. 
LINE 1 
LINE 2 
LINE 3 
LINE 4 
LINE 5 
LINE 6 
LINE 7 
LINE 8 
LINE 9 
LINE 10 
--EOR-- 
READY. 



ABCDEFGHIJ 
BCDEFGHIJK 
CDEFGHIJKL 
DEFGHIJKLM 
EFGHIJKLMN 
FGHIJKLMNO 
GHIJKLMNOP 
HIJKLMNOPQ 
IJKLMNOPQR 
: JKLMNOPQRS 



SAVE,TEST=TEXT1 
READY. 



This is verified with another 
listing. 



EDIT - 



In addition to using this file in 
the subsequent EDIT operations, the 
user feels he may need it for other 
testing anu niaKes a permanent iIlg 
(indirect access) called TEXTl. 
The original copy, called TEST, re- 
mains as the primary file. 

■Enters the Text Editor 



BEGIN 
? LIST 

LINE 1: 
? LIST; 



TEXT EDITING. 



ABCDEFGHIJ 



List the first line. Pointer remains 
at the first line. 

List the first three lines. 



LINE 1 
LINE 2 
LINE 3 
? LIST 

LINE 3; 



ABCDEFGHIJ 
BCDEFGHIJK 
CDEFGHIJKL 

/JKL/ o 



CDEFGHIJKL 



List the first line in which the 
phrase /JKL/ occurs 
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? LIST:/JKL/;3 - 



LINE 3 

LINE 4 
LINE 5 
? LIST 

LINE 3 
LINE 4 
? LIST 

LINE 3 
LINE 4 
LINE 5 
LINE 6 



CDEFGHIJKL 
DEFGHIJKLM 
EFGHIJKLMN 
/JKL/, /GHI/. 



CDEFGHIJKL 
DEFGHIJKLM 
/JKL/, /GHI/;3 



CDEFGHIJKL 
DEFGHIJKLM 
EFGHIJKLMN 
FGHIJKLMNO 



? LISTS: /DEFG/ - 



DEFG 
? LISTS:/DEFG/;3 - 



DEFG 
DEFG 
DEFG 
? LISTS:/LMN/, /NOP/*- 



LINE 6: 
LINE 7: 
? FIND; 5 *. 
LINE 6: 



LMN 
FGHIJKLMNO 
GHIJKLMNOP 



FGHIJKLMNO 



■List the first three lines in which 
the phrase /JKL/ occurs. 



List the line(s) in which the string 
beginning with /JKL/ and ending l 

with /GHI/ first occurs. I 

■List the lines that contain the first 
three occurrences of the string beginning 
with /JKL/ and ending with /GHI/. 



List the first occurrence of the 
phrase /DEFG/. 

List the first three occurrences of 
the phrase /DEFG/. 



List the first occurrence of the 
string beginning with /LMN/ and 
ending with /NOP/. 

Move the pointer five lines and list 
the new line. Pointer remains at new 
line. 



? FIND:/DEF/;3- 

PHRASE NOT FOUND. 



Move the pointer another three lines 
and list the first line in which the 
phrase /DEF/ occurs. Pointer has 
moved beyond the range of this phrase 
and hence it is not found. 



?RESET 



? FINDS: /DEF/;3 - 
DEF 



? RESET *■ 



• Moves the pointer back to the 
beginning of the file. 

Moves the pointer three lines and lists 
the first occurrence of /DEF/. 

Moves the pointer back to the first 
line. 



? ADD;2 *- 



Calls for text to be added after the 
second line. 
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ENTER TEXT. 
? /FIRST INSERTION/ 

READY. 
? ADD;4 .. 

ENTER TEXT. 
? /SECOND INSERTION/ 

READY. 
? ADB-./MNO/^ 

ENTER TEXT. 
? /THIRD INSERTION/ 

READY. 
? ADDS:/MNO/-^ 

ENTER TEXT. 
? /FOURTH INSERTION/ 

READY. 

? SET;8 ^ 

? DELETE;2 

? RESET 

?LIST;* 

LINE 1: ABCDEFGHIJ 

LINE 2: BCDEFGHIJK 

FIRST INSERTION 

LINE 3: CDEFGHIJKL 

SECOND INSERTION 



Calls for text to be entered after 
the fourth line. 



■Calls for text to be entered after the 
first line in which /MNO/ occurs. 



Calls for text to be entered immediately 
after the phrase /MNO/. 



LINE 


4 


DEFGHIJKLM 


LINE 


5 


EFGHIJKLMN 


LINE 


6 


FG HIJKL MNO FO URT H 


LINE 


8 


HIJKLMNOPQ 


LINE 


9 


IJKLMNOPQR 


LINE 


1 


3: JKLMNOPQRS 



■The pointer is moved down eight lines 
and then the next two lines are deleted. 
Taking into account the above insertions, 
it should stop at /THIRD INSERTION/ and 
then eliminate that line and the next 
one (line 7). 

The pointer is moved back to start and 
a listing made of the entire file. 



INSERTION 



-END OF FILE- 
? OLD, TEXT 1 

OLD SYNTAX ERROR. 
? END 

END TEXT EDITING. 
READY. 

OLD, TEXT 1 
READY. 

EDIT 
BEGIN TEXT EDITING. 
? CHANGE;3 -. 



ENTER TEXT. 
? /AAA 
? BBB 
? CCC/ 

READY. 
? CHANGE: /JKLM/*- 

ENTER TEXT. 
? /OO 
? OO 
? OO/ 

READY. 



The user would like to get back the 
original format of this file. Since the 
original is an indirect access permanent 
file, he calls for a copy to be entered 
as the primary file (OLD). But commands 
cannot be entered from the Text Editor. 
Accordingly, he exits fronn EDIT, enters 
his OLD, and then reenters EDIT. 



■ Change the first three lines to the 
text that follows. 



Change the first line with the phrase 
/JKLM/ to the text that follows. 
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? LIST;* ♦ 
AAA 




BBB 




ccc 




oo 




oo 




oo 




LINE 5 




EFGHIJKLMN 


LINE 6 




FGHIJKLMNO 


LINE 7 




GHIJKLMNOP 


LINE 8 




HIJKLMNOPQ 


LINE 9 




IJKLMNOPQR 


LINE 10: 


JKLMNOPQRS 


-END OF 


FILE- 


? END< 







END TEXT EDITING. 
READY. 



A listing of the modified file 
verifies the changes. 



Exits from the Text Editor. 



BASIC *- 
READY. 



Enters the BASIC subsystem. 



NEW, DEMO 
READY. 



Establishes new primary file. 



AUTO- 

00100 INPUT N 

00110 PRINT TAB(169;"INTEGERS", "SUM" 

00120 LET S = 

00130 FOR 1=1 TO N 

00140 S=S+I 

00150 PRINT TAB(19);I, S 

00160 NEXT I 

00170 END 

00180 ^DEL-" 

NORMAL 
READY. 



Enters AUTO mode so that the system 
will supply line numbers 



■Deletes this line so he can type 
NORMAL and exit AUTO mode. 



90 REM SUMMATION OF THE FIRST N INTEGERS Adds comments 

95 REM THE VALUE OF N TO BE USSP SUPPLIED AT EXECUTION to beginning of 

program. 



RESEQ, 1000, 1000 



Resequences line 
numbering to begin 
at 1000 and increase in 
increments of 1000. 



CP 

READY. 



0.028 SECS. 
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LIST 

72/12/29. 10.46.27. 
PROGRAM DEMO 



A listing shows the new line numbers 



01000 REM SUMMATION OF THE FIRST N INTEGERS 

02000 REM THE VALUE OF N TO BE SUPPLIED AT EXECUTION 

03000 INPUT N 

04000 PRINT TAB(169;"INTEGERS", "SUM" 

05000 LET S = 

06000 FOR 1=1 TO N 

07000 S=S+I 

08000 PRINT TAB(19);I,S 

09000 NEXT I 

10000 END 

READY. 



RNH 
ILLEGAL STATEMENT AT 4000- 



■Refers to typo error in line 04000. 



CP 0.017 SECS. 

RUN COMPLETE. 

04000 PRINT TAB(16);"INTEGERS", "SUM" Corrected statement. 
RNH 



? 10 



INTEGERS 



CP 0.037 SECS. 

RUN COMPLETE. 



SUM 



2 


3 


3 


6 


4 


10 


5 


15 


6 


21 


7 


28 


8 


36 


9 


45 


10 


55 



Program is executed and the input 
for N is 10. 



J. lie Ui illLUUL lUii-UWO. 
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SAVE, DEM0=DEM01 
ILLEGAL PARAMETER. 



SAVE, DEMO =DEMO 1 - 
READY. 



Decides to make this program an 
indirect access permanent file 
called DEMOl. The first attempt 

fails because of the space after 

the comma. Note DEMOl will have £ 
BASIC subsystem flag associated 
with it because that subsystem is 
in effect when the file is saved. 
Hereafter, when the file is accessed 
(using the OLD command), the BASIC 
subsystem will also be selected. 

1000 REM SUMMATION OF THE ODD INTEGERS 

2000 Alters the program to sum the odd 

6000 FOR 1=1 TO N STEP 2 integers 

RESEQ, 1000, 1000 



CP 
READY. 



0.028 SECS. 



RNH 
? 8 * 



INTEGERS 
1 
3 
5 
7 

CP 0.026 SECS. 

RUN COMPLETE. 



SUM 
1 
4 
9 
16 



SAVE, DEMO =DEM02 
READY. 



NEW, TEST 
READY. 



Enters the value 8 for N in the 
request for input. 



-Makes this altered program an 
indirect access permanent file 
which he calls DEM02. This file 
will also have a BASIC subsystem 
flag associated with it. 

■Establishes a new primary file. 



BATCH 



Enters the BATCH subsystem. 



$RFL,20000.*- 



/DEFINE, ALPHA- 



By default, the system supplies a 
field length of 20000 octal words. 

Creates an empty direct access 
permanent file called ALPHA. 
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/COPYCR (INPUT, ALPHA, 3)*- 

? FILE ALPHA - RECORD 1 

? 

? 

9 

? RECORD 2 

? 

? 

? 

? 

? 

? 

COPY COMPLETE. 

/LIST,F=ALPHA 

COPY COMPLETE. 
/REWIND, ALPHA 



LINE 1 
LINE 2 
LINE 3 

LINE 1 
LINE 2 



RECORD 3 - LINE 1 
LINE 2 
LINE 3 



Calls for input to the permanent file 
in the form of three records 



This data is written directly on 
the direct access file without 
any local copy. 



Calls for a listing of this direct 

access file. 

Gets a null record because he has 

not rewound. 

He rewinds and lists successfully. 



$REWIND, ALPHA. 
/LIST,F=ALPHA 








FILE ALPHA - RECORD 

RECORD 
RECORD 


1 

2 
3 


- LINE 
LINE 
LINE 

- LINE 
LINE 

- LINE 
LINE 
LINE 


1 
2 
3 
1 
2 
1 
2 
3 










/l-'ORTRAN 
READY. 


NEW, TEST -« 









Enters the FORTRAN subsystem. 



Creates a program that generates 
tables of logarithms for various bases, 



lOOCPROGRAM TO CREATE A TABLE OF LOGARITHMS 

llOCFOR ANY BASE FROM 0.1 TO 9.9 

120 PROGRAM TEST(INPUT, OUTPUT) 

130 READ, N, BASE 

140 DO 1 1=1, N 

150 READ, VALUE 

160 BLOG - ALOG10(VALUE)/ALOG10(BASE) 

170 PRINT 10, BASE, VALUE, BLOG 

180 1 CONTINUE 

190 10 FORMAT (9 HLOG (BASE , F3. 1, 2H ), F6. 2, 

200+3H = ,F10.8) 

210 END 
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? 4,2 .1 

? 2 

LOG(BASE 2.0 ) 2.00 = 1.00000000 
? 4 

LOG(BASE 2.0 ) 4. 00 = 2.00000000 
? 8 

LOG(BASE 2.0 ) 8. 00 = 3.00000000 
? 64 

LOG(BASE 2.0 ) 64.00 = 6.00000000 
END. 



Input states that there will be four 
entries for which the program will 
determine the logarithms to the base two. 



CP 



0.157 SECS. 



RUN COMPLETE. 

SAVE, TEXT=LOGl - 
READY. 



170 WRITE 10, BASE, VALUE, BLOG 
RNH 



The primary file is made an indirect 
access permanent file with the name LOGl. 
This file will have a FORTRAN subsystem 
flag associated with it. 

He wants to modify the local copy of the 
program so that it will write a local 
file rather than give a printout. 



AT LINE NUMBER 170 UNRECOGNIZABLE STATEMENT 
000001 FORTRAN ERRORS IN TEST 

He gets the format wrong. 



CP 



0.085 SECS. 



RUN COMPLETE. 

120 PROGRAM TEST(INPUT, TAPED 
170 WRITE(1,10) BASE, VALUE, BLOG 
RNH 



? 3,8 

? 8 
? 64 
? 512 
END. 

CP 0. 164 SECS. 

RUN COMPLETE. 



He realizes that in addition to correcting 
statement 170, he must alter the header 
line to establish a local file to write 
on. He drops the OUTPUT file since 
there will be no printout. 

Input states that there will be three 
values entered for which the program is 
to determine the logarithms to the base 
eight . 
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REWIND 1-^ 

ILLEGAL COMMAND. 



He wants to see what he has written 
on the local file. He remembers to re- 
wind but gets the form wrong. 



REWIND, TAPEl- 



This is right. 



CP 

READY. 



0.001 SECS. 



LNH,F=TAPE1 - 



Listing gives him what he wanted. 



LOG(BASE 8.0 ) 8.00 = 1.00000000 
LOG(BASE 8.0 ) 64.00 = 2.00000000 
LOG(BASE 8.0 )512.00 = 3.00000000 



CP 

READY. 



0.004 SECS. 



SAVE,TEST=LOG2 *■ 
READY. 



■He makes an indirect access permanent 
file of this altered program which he 
calls L0G2. This file will also have 
a FORTRAN subsystem flag associated 
with it. 



BYE 



The user logs off the system. 



USER123 
USER123 



LOG OFF. 
CP 



11. 10.30. 
0.870 SEC. 



G-10 



60407600 A 



GLOSSARY 



Alphanumeric 



Answerback code 



APL 
ASCII 

Auxiliary device 

BASIC 

Catalog 

Compile 

Control card 
Direct access file 

Display code 



A combination of intermixed alphabetic and numeric 
characters. 

A character code which uniquely identifies a tele- 
typewriter unit. If this code is present in the 
user's validation file, the user's activities are 
limited to this particular unit. The code is set 
on a drum within the TTY. KRONOS checks only 
the first ten characters. 

A Programming Language. An interactive inter- 
preter available to the time- sharing user. 

American National Standard Code for Information 
Interchange; the 12 8 -character set utilized by KRONOS 
for the terminal user. 

Mass storage permanent file device used to supple- 
ment storage provided by the normal permanent 
file devices associated with the system (refer to 
family device). 

Beginner's All-purpose Symbolic Instruction Code; 
an elementary programming language available to 
the KRONOS user. 

The list of permanent files saved under a particular 
user number; this list also contains information 
about the permanent files. 

To translate a program from a higher level program- 
ming language (for example, FORTRAN or BASIC) 
into machine instructions. 

Instruction to the operating system to perform a 
specified task or utility. 

A permanent file which can be attached to the user's 
job. All changes to this file are made on the file 
itself rather than to a working copy of the file. 
(Refer to indirect access file. ) 

An internal code set used by CDC CYBER 70 series 
and 6000- series computers to represent alphanumeric 
and special characters. (Refer to Table B-2 in 
appendix B. ) 
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EOF 

EOI 

EOR 

Escape key 

Family device 



Field length 
File 

Flag 
FORTRAN 

Indirect access file 

Interactive 



Library file 

Local file 

Locked file 
Logical record 



End- of- file 

End- of- information 

End- of- record 



These represent the 
method by which files are 
defined and structured. 
Refer to the discussion 
in section 3. 



The ESC key on ASCII code terminals which allows 
the user to delete the current line of input. 

Mass storage permanent file device associated with 
a specific KRONOS system. A family may consist 
of 1 to 63 logical devices. Normally, a system 
runs with one family of permanent file devices 
available. However, additional families may be 
introduced during normal operation. This enables 
the users associated with the additional families 
to access their permanent files via an alternate 
system. 

Number of central memory words required to 
process a job. 

Either a program or data, made up of one or more 
groups of data separated by EORs and EOFs and 
terminated by an EOI. 

A character or bit that signals the occurrence or 
presence of a particular condition. 

The FORmula TRANslation compiler that converts 
algebraic and scientific problems into machine 
language instructions. 

A permanent file which is accessed by use of a 
working copy of the file rather than by working on 
the file directly. 

Job processing in which the user and the computer 
communicate with each other, rather than the user 
merely submitting his job, receiving output, and 
having no control over the job while processing 
occurs. 

A permanent file residing under the special user 
number LIBRARY. 

Any file assigned to a user while he is logged in 
at a terminal. Same as a working file. 

A file on which a user cannot write. 

A record whose length is a function of the infor- 
mation it contains rather than the device on which 
it is stored. 
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Master device 

Object code 

On-line 

Order- dependent 

Order- independent 

Parameter 
Permanent file 

Permanent file family 

Physical record unit (PRU) 

Port 

Post radix 

Prefix character 
Primary file 



Private auxiliary device 



Mass storage device that contains the user's per- 
manent file catalog, all his indirect access files, 
and all, part, or none of his direct access files. 

Executable machine language instructions. An 
object code program need not be recompiled each 
time it is executed. 

Equipment under direct control of the computer. 

Items which must appear in a specific order. 

Items which need not be given in any specific order. 
Parameters may be order- independent. For 
example, the UN=usernum parameter in the GET 
command is order- independent. 

A variable that is given a specific value for a 
particular purpose or process. 

A file which is created by a user, stored under 
his user number in the permanent file system, and 
is removed from permanent file storage only when 
specified by the user. 

Permanent files which reside on the family devices 
of a specific KRONOS system. 

The standard unit of data storage defined by the 
device on which a file resides. 

The point at which a communication line is attached 
to the computer system. 

A letter following a numeral that indicates the base 
numbering system. 

A character that has a special significance to a 
program or the operating system. 

Any working file defined with the OLD and LIBRARY I 
command or initiated with the NEW command. The I 
primary file is assumed to be the file on which 
most operations are performed unless another file 
is specified. The primary file is automatically 
sorted by the system and rewound after each use. 

Auxiliary device associated with a specific user. 
Only that user may create files on the device, 
although he may permit other users to access files 
which reside on the device. 
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Public aiixiliary device 



Rollout file 
Rubout characters 

Source code 

Swapping 

System file 

System utilities 
Time slice 

TTY 
Validation file 

Working file 



Auxiliary device available for access by all validated 
users knowing the correct packname. Note that 
additional validation is required to create or replace 
files on an auxiliary device (refer to LIMITS com- 
mand in section 4). 

A file containing a job (and system information) 
that has been temporarily removed from the main 
processing area of the system. 

Characters created by pressing the RUBOUT key 
on the terminal. These are considered null input 
by the system and are required in paper tape 
input. 

Code input to the computer for later translation 
into executable machine language instructions 
(object code). 

The process of removing one job from central 
memory and replacing it with another job. 

A file that can be accessed only by a system 
program. 

System programs used to perform system functions. 

The amount of CPU time a job is allowed to use 
before the system lowers its priority to allow 
other jobs to execute. 

Teletypewriter. 

File containing validation information for all users 
(user numbers, passwords, resources allowed, etc.) 

Any file assigned to a user while he is logged in 
at a terminal. 
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Abbreviating commands 4- 1 

Access mode 5-1 

Accidental disconnect 4-16,19; 7-5 

ACCOUNT card image 8-2; 9-1 

Accumulated CPU time 4-20 

Acoustic coupler B-1 

Alternate catalog requests 5-1, 3, 13 

Alter line numbers 4-3 

Alternate log- off /log- in 6-12 

Alternate user access 5-1, 3, 18 

APL character set B-5, 6 

A PL command 4-9 

APL print selection (see TERM command) 

APPEND command 5-6 

Append mode 5-3 

Answerback 4-23 

ASCII character set 4-2, 3; B-5, 6 

ASCII code terminals 1-2; 2-1, 2; 4-2, 3, 

5, 9, 12, 19, 20, 22; 6-2, 3, 4, 5; 7-3; B-3 
ASCII command 4-2,3 
ATTACH command 5- 1,2,6, 10, 22 
Automatic generation of line numbers 

3-3; 4-3 
Automatic read-only permission 5-1 
Automatic subsystem selection 3-3; 

6-9; 5-12 
AUTO command 3-3; 4-3 
Auto mode 4-3 
Automatic rewind 3-3 
Auxiliary device 5-1, 5, 6, 10 



Backspace key 4-2,3; 6-2; B-3 
BASIC command 4-6 
BASIC subsystem 1-2; 2-2; 7-2 
BATCH command 4-7; 9; 1 
Batch job image 8-1 
Batch queue 4-21; 8-1, 5 
BATCH subsystem 1-2; 4-7; 9-1 
Baud rate switch 2-1; 6-4 
BINARY command 4-10 
Binary file 4-8,17 
Binary input mode 4-10 
Block size 

indirect access file 5-2 

direct access file D-1 
BOI (beginning- of- information) 3-1; 8-5 
BYE command 2-5; 3-7; 4-10; 5-7; 6-11 



Call procedure file 4-22 

Catalog entries 5- 12, 13, 14, 15 

CATLIST command 5-12, 16, 17, 18, 19, 20, 

21,22 
Carriage return (see RETURN key) 
ciECc2 directive 8-5 

Central memory character equivalents B-4 
cEOF directive 8-3 
cEOR directive 8-3 
CHANGE command 5-7 
Change working file name 4-16 
Character count delay (see ROUT command) 
Character set 4-2; B-5, 6 
CHARGE command 2-3; 4-11; 6-8 
Charge /project number 2-3; 4-11; 6-8 
cJOB directive 8-2 
CLEAR command 3-7; 4-11; 5-7 
cNOPACK directive 8-3,5 
cNOSEQ directive 8-3 
cNOTRANS directive 8-2,4 
Command 

abbreviation 4- 1 

entry of 4-1, 2 

error correction 4-2 

format, permanent files 5-2, 12 

index to (see inside front cover) 

minimum number of characters 4-1 

processing 4-1 

uniqueness 4- 1 
Compiling (see object code generation) 
conventions, operating 1-2 
Connect terminal via acoustic coupler B- 1 
Connect terminal via data set B- 1 
Continue job after suspension 7-3 
Control cards 4-22; 8-1; 9-1 
Control keys B-3 
Control record 8-5 
COR (see TERM command) 
CORAPL (see TERM command) 
Correcting errors 4-2 
Correct input line 6-2 
Corrections to paper tape C-4 
Correcting statements in program 7-1 
Correspondence code terminals 1-2; 2-1, 2; 

4-2, 3, 5, 9, 10, 12, 19, 20, 22, 24; 6-2, 3, 4, 5; 

7-3; B-3 
cPACK directive 8-3, 5 
CPU time, accumulated 4-20 
cREAD directive 8-4 
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cREWIND directive 8-4, 5 
cSEQ directive 8-3 
c TRANS directive 8-2, 3 
CTRL key C-2 



Delay carriage return (see ROUT command) 

DEFINE command 5-1,5,8 

Data set B-1 

DAYFILE command 4-11 

DAYFILE control card image 8-5 

Delete input lines 4-3; 6-3; B-3 

Delete program statement 7-1 

Device availability 5-6, 15 

Dial- in procedure B-1 

Direct access files 5-1 

Disconnect terminal 2-5; 4-10, 11 

Display code B-5, 6 



EDIT command 3-5; 4-11 
Entry 

charge /project number 2,3; 4-11; 6-8 

errors 4-2 

family name 6-5 

file name 2-3; 3-2, 6; 4-6, 9; 5-2, 6; 
6-8; 8-1 

file status 2-3; 4-6,20; 6-8; 8-1 

lower case letters 4-2,3 

numbers 4-2 

password 2-2; 4-16; 6-5 

subsystem 2-2, 3; 4-6; 6-8 

system commands 4- 1 

terminal identification 2-2; 6-7 

terminal type 4-5 

user number 2-2; 6-5 
EOF (end- of- file) 3-1; 8-3,4,5 
EOI (end-of- information) 3-1 
EOR (end- of- record) 3-1; 8-3,4,5 
Error correction 4-2 
Error messages A-1, 2, 3 
ESC (ESCAPE) key 4-2,3 
Escape character 8-1 
Escape code convention 4-3 
Even/odd parity switch 2-1; 6-4 
Even parity 4-5 
Examples 

AUTO command 4-4 

auto subsystem selection 3-3; 6-10 

BASIC usage 2-4 

CATLIST command 5-16, 17, 18, 19, 20, 21 

commands and effect on files 3-6 

delete input line 6-3 

ESC (ESCAPE) key usage 4-4; 6-3 

file modification 3-5; 7-1 



listing a file 3-4 

log- in 2-3; 6-9 

NODROP command 3-6 

PACKNAM command 5-11 

paper tape usage C-4 

program editing 7- 1 

program entry /execution 2-4 

recovery 7-7, 8, 9 

RUN command 4-18 

STATUS command 4-20 

Text Editor usage G-1 

time limit 7-5 

time- sharing session G-1 

use of I key 7-4 

user validation limits 4-25 
EXECUTE command 4-7 
EXECUTE subsystem 1-2; 4-7 
Execution of program 2-4; 3-6; 4-7, 8, 17 

19; 6-10 
EXIT control card image 8-5, 6 
Exit from BATCH subsystem 9-2 
Export /Import 4-21; 8-1,5 



Family name 6-5 

Field length required for control cards 

4-7; 9-1 
Field length specified on RUN command 

4-17 
File 

catalog 5- 1 

category 5-3 

direct access 5-1,2 

indirect access 3-2; 5-1 

inhibit sorting 3-4 

name entry 2-3; 3-2, 6; 4-6, 9; 5-2, 6; 
6-8; 8-1 

organization 3-1 

permission information 5-13 

positioning 3-3; 4-17 

processing 3-1 

reformatting 8-2 

residency 5-4, 14 

space specification 5-5 

sorting 3-3; 4-19 

status entry 2-3; 4-6,40; 6-8; 8-1 

structure 3-1 

subsystem association 3-3 

usage 3-1 

working 3-2 

working copy of 5- 1, 2 
FORTRAN command 4-8 
FORTRAN subsystem 1-2; 4-8; 7-2 
FULL command 4-4 
Full duplex /half duplex (FDX/HDX) switch 

2-1; 4-4; 6-4 
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Generate binary (object code) file 

4-17; 6-11 
GET command 3-2; 5-9, 10, 22; 9-2 
GOODBYE command 3-7; 4rll; 5-7; 6-11 
Guide to first session 2-1 



HALF command 4-4 

HELLO command 3-7; 4-11; 5-7 

HELP command 4-12 



I key 4-12; 7-3 

Improper log- in 6-6 

Increment jobs field length 4-17 

Index to commands (see inside front cover) 

Indirect access files 3-2; 5-1 

Inhibiting header messages 4-5 

Input to executing program 6-3 

Input /output conventions 6-1 

Inserting statements in program 7- 1 

Interrupt program 4-12, 19; 6-3; 7-3; B-3 

Introduction to KRONOS 1-1; 2-1 

Invalid commands 4-2 



Locked file 4-13 

Logical record 3- 1 

LOGIN command 3-7; 4-14; 5-7 

Log- in procedure 2-1; 6-4 

Log- off procedure 2-5; 6-11 

Lost data 6-4 

Lost files 7-6 



MEMAPL (see TERM command) 
Minimum number of characters in 

command 4- 1 
Modify mode 5-3 
Multi-f ile file 3-1 
Multiple file requests 9-2 



NEW command 3-2,6; 4-14; 5-7 

NODROP command 3-6; 4-8, 13, 14,^ 15; 5-10 

NORMAL command 4-5 

Normal mode 4-5 

NOSORT command 3-4; 4-12, 14, 15, 17 

NULL command 4-9 

NULL subsystem 102; 3-3; 4-6, 9; 5-10, 12 



JOB card image 8-2 
Job 

name 4-21; 8-2 

status 4-20 

suspension 4-12; 7-3 

termination 4-19,21 



KCL (KRONOS control language) 
Keyboard configuration B-2 
Keyword 5-2, 3, 12 
Kilo physical records 4-13 
KRONOS character set B-5, 6 
KRONOS control language (KCL) 



4-22; 8-1 



4-22; 8-1 



LENGTH command 4-12, 13 
Length of input/output lines 6-2 
-Ifn (procedure file call) 4-22 
LIBRARY command 3-2, 6; 4-13; 5-1, 7, 

10,22 
LIMITS command 4-13,23 
Line feed (LF) character C-2 
Line numbers 3-3; 4-3 
Line overflow 6-4 
LIST command 3-4; 4-14 
LNH (list- no- header) command 4-14 
Local files (see working files) 



Object code execution 4- 7, 8 

Object code generation 4-17; 6-11 

Odd parity 4-5 

OLD command 3-2,6; 4-6, 8, 15; 5-1,7, 10, 

22; 6-9; 9-2 
Operating procedures 6-4 
Order dependent options 4-17; 7-3 
Order independent options 5-2, 12 
Output file name 5-14 



PACK command 3-5; 4-15, 22 
Pack working file 3-5; 4-15, 19 
PACKNAM command 5-10 
Packname specification 5-5, 14 
Paper tape operations C- 1 
Paper tape punch control keys C- 1 
Paper tape reader 4-5 
Paper tape reader control keys C- 1 
PARITY command 4-5 
Parity switch 2-1; 6-4 
PASSWOR command 4-16 
Password 2-2; 4-16; 5-3; 6-5 
Permanent file 

catalog 5- 1 

command format 5-2 

commands 5- 1, 6 
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family (see family name) 

storage 3-3; 4-8 

m.ode of access 5-1, 2 

name 5-13 

types 5-1,2 
Permission 5-13, 19 
Permission mode 5-3 
PERMIT command 5-11 
Post radix 4-2 
Primary file 3-2, 3, 4, 6, 7; 4-6, 7, 9, 13, 14, 

15,16,19,21; 5-7,10,12; 6-1 
Private files 5-3, 18 
Procedure file usage 4-22 
Program editing 3-5; 6-1; 7-1,2 
Program execution 2-4; 3-6; 4-7, 8, 17 
PRU (physical- record- unit) 3-1 
Public files 5-3,21 
Punching a paper tape off-line C-2 
Punching a paper tape on-line C-3 
Punch paper tape leader/ trailer B-3, C-3 
PURGE command 5-11 



Question mark 6-3; 7-4 



Read mode 5-3 
Read with append mode 5-4 
Read with modify mode 5-4 
RECOVER command 4-12,16 
Recovery 7-3,5,6,7,8,9 
Recovery of two or more users 
Reformatting a file 8-2 
Reformatting directives 8-3 
Releasing permanent files (see PURGE 

command) 
Releasing working files 3-2, 6, 7; 4- 11 
Remote job entry 4-21; 8-1 
RENAME command 4-16 
REPLACE command 4-8; 5-11; 7-2; 8-5 
Requests for input 6-3; 7-4 
RESEQ command 4-16 
Resequencing line numbers 4-16; 7-2 
Reserved file names F- 1 
RESOURC control card image 5-6, 15 
RESTORE statement 3-3 
RETURN command 4-17; 5-7 
RETURN key 1-2; 6-2 
REWIND command 3-3; 4-17 
RFL control card image 9- 1 
RNH (run- no- header) command 4-19 
ROUT command 4-5 
RUN command 2-4; 3-6; 4-7, 17; 6-10 



7-7 



SAVE command 3-3; 4-6, 8; 5-1, 10, 12; 9-2 

Semiprivate file 5-3,20 

Set time limit 4-19 

SETTL command 4-19; 7-3 

Short form log- in 6-9 

S key 4-19 

SORT command 3-4; 4-19 

Sort flag 3-4; 4-19 

Source code 3-3 

Standard character set B-5,6 

Standard input lines 6-1 

Standard print selection (see TERM command) 

STATUS command 3-4; 4-6, 20 

Steps in job processing 6-4 

STOP command 4-21; 7-4 

SUBMIT command 4-21; 8-1 

Submit error processing 8-5 

Subsystem association with permanent files 

(see Subsystem flag) 
Subsystems available under KRONOS 1-2 
Subsystem exit 9-2 

Subsystem flag 3-3; 4-6, 8, 9; 5-12; 6-9 
Subsystem selection, automatic 3-3,4 
Subsystem selection commands 2-2; 4-6; 

6-7 
Successful recovery 7-6 
Suspend job 4-12; 7-3 
System commands 4- 1 
System malfunction 7-5 



TAPEl 8-4 

TAPE command 4-5; 7-3 

Tape mode 4-5; C-3 

TERM command 4-5 

Terminals 1-1 

Terminal 

control commands 4-2 

control keys B-3 

identification 2-2; 4-20; 6-4, 5 

job processing 6-4 

number 2-2; 4-20; 6-7; 7-6 

parity 4-5; 6-4 

print t3^e (see TERM command) 
Terminate 

executing program 6-3 

input line 6-2 

output 4-19 

program 4-19,21; B-3 
TEXT command 4-21,22 
Text editing 3-5; 6-1; 7-1, 2 
Text Editor 4-11; 6-1; 7-1 
Text Editor commands E-1 
Text mode 3-3,4; 4-21; 6-1; B-3 
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Time limit specification 4-19, 23; 7-4, 5 user 4-2, 13, 16, 17, 19, 23, 24, 25; 5-1, 

Time-Sharing job commands 4-9 5-5, 8, 11, 12, 15; 8-1 

Time- Sharing job processing 6-1 

T, nnnnn 7-4 

Transparent m.ode 8-2 

TTY (see TERM command) Working copy of file 5-1 

Types of permanent files 5-1 Working files 3-2; 4-6, 9 

Working file control 3-6 
Write interlock 5-2 
Write mode 5-3,7,8 

Unsuccessful log- in 2-1; 6-6 

Unsuccessful recovery 7-6 

User number, entry of 2-2; 6-5 

X, nnnnn 9-2 

X-OFF character C-2 

X-ON character 4-5 

Validation 

limits 4-13,23 



60407600 A Index- 5 



COMMENT SHEET 

MANUAL TiTiF CONTROL DATA® KRONOS 2. 1 Time-Sharing User's 



Reference Manual 



PiiRiirATinwwn 60407600 B 
PUBLICATION NO . . REVISION 



FROM: name: 



business 
address:. 



COMMENTS: 

This form is not intended to be used as an order blank. Your evaluation of this manual will be welcomed 
by Control Data Corporation. Any errors, suggested additions or deletions, or general comments may 
be made below. Please include page number references and fill in publication revision level as shown by 
he last entry^n the Record of Revision page at the front of the manual. Customer engineers are urged 



Z| 

o 

-J 

< 

H 

:d 
o 



NO POSTAGE STAMP NECESSARY IF MAILED IN U. S. A. 

FOUD ON DOTTED LINES AND STAPLE 



STAPLE 



STAPLE 



FOLD 



FOLD 



FIRST CLASS 
PERMIT NO. 8241 



MINNEAPOLIS, MINN. 



BUSINESS REPLY MAIL 

NO POSTAGE STAMP NECESSARY IF MAILED IN U.S.A. 



POSTAGE WILL BE PAID BY 

CONTROL DATA CORPORATION 

Technical Publications Department 
4201 North Lexington Avenue 
Arden Hills, Minnesota 55112 




o 
z 
o 
< 

u 



FOLD 



FOLD 



